From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#10072: 23.3; invisible text Date: Sun, 20 Nov 2011 16:27:11 -0800 Message-ID: <5376D105CD20484990AAB55C158138B0@us.oracle.com> References: <20111118191436.GA21091@sfu.ca><20111120102459.GB12774@sfu.ca> <20111121000321.GA19808@sfu.ca> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1321835282 2963 80.91.229.12 (21 Nov 2011 00:28:02 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Mon, 21 Nov 2011 00:28:02 +0000 (UTC) Cc: 10072@debbugs.gnu.org To: "'Andrew Kurn'" , "'Stefan Monnier'" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Nov 21 01:27:57 2011 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1RSHjo-0001Ic-Os for geb-bug-gnu-emacs@m.gmane.org; Mon, 21 Nov 2011 01:27:57 +0100 Original-Received: from localhost ([::1]:36597 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RSHjn-0004jY-Is for geb-bug-gnu-emacs@m.gmane.org; Sun, 20 Nov 2011 19:27:55 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]:41298) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RSHjl-0004jT-62 for bug-gnu-emacs@gnu.org; Sun, 20 Nov 2011 19:27:54 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RSHjk-0005dF-6D for bug-gnu-emacs@gnu.org; Sun, 20 Nov 2011 19:27:53 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:57989) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RSHjk-0005dB-3R for bug-gnu-emacs@gnu.org; Sun, 20 Nov 2011 19:27:52 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1RSHks-0001t1-Dz for bug-gnu-emacs@gnu.org; Sun, 20 Nov 2011 19:29:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 21 Nov 2011 00:29:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 10072 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 10072-submit@debbugs.gnu.org id=B10072.13218353097212 (code B ref 10072); Mon, 21 Nov 2011 00:29:02 +0000 Original-Received: (at 10072) by debbugs.gnu.org; 21 Nov 2011 00:28:29 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RSHkL-0001sH-Fx for submit@debbugs.gnu.org; Sun, 20 Nov 2011 19:28:29 -0500 Original-Received: from rcsinet15.oracle.com ([148.87.113.117]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RSHkK-0001sA-7H for 10072@debbugs.gnu.org; Sun, 20 Nov 2011 19:28:29 -0500 Original-Received: from acsinet21.oracle.com (acsinet21.oracle.com [141.146.126.237]) by rcsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id pAL0RFlN004773 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Mon, 21 Nov 2011 00:27:16 GMT Original-Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by acsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id pAL0RElB017201 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Mon, 21 Nov 2011 00:27:15 GMT Original-Received: from abhmt103.oracle.com (abhmt103.oracle.com [141.146.116.55]) by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id pAL0R9cv004401; Sun, 20 Nov 2011 18:27:09 -0600 Original-Received: from dradamslap1 (/10.159.41.13) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sun, 20 Nov 2011 16:27:09 -0800 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: <20111121000321.GA19808@sfu.ca> Thread-Index: Acyn4RZEdqYtHFOESWy7+9H2e6tx8AAAffGg X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: acsinet21.oracle.com [141.146.126.237] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090202.4EC99AE4.0077,ss=1,re=0.000,fgs=0 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Sun, 20 Nov 2011 19:29:02 -0500 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:54106 Archived-At: > > Fundamentally it's a bug, and I generally don't like to > > document bugs. > > On this point I disagree with you very strongly. It's much /more/ > important to document bugs than any other aspect of the code. I have > told several students this from time to time, and, like you, they > tend to resist the idea. > > I gather that there is no great push on to remedy this behavior, > so this bug may hang around for some time . . . FWIW - Bugs, other known problems, and workarounds are typically *not* documented as part of the technical doc itself. One reason for this is that the doc is meant to describe what the product does, or rather, what it should do, what it is supposed to do. In a way, the doc is like a spec that the product is meant to reflect. Selected bugs and workarounds are, however, often documented in accessory, release-specific documents such as release notes and readmes. One of the main purposes of release notes and such is to let users know about certain known problems and limitations, and how they might work around them. And of course bugs are also often documented (after a fashion) in a bug tracking system. For user-visible bugs, that gives users a sense of the history and fix progress.