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#6113: 23.1.97; doc of :box face attibute Date: Sat, 2 Jul 2011 18:34:51 -0700 Message-ID: <67BCAC84ECA54A4583078D8664B9B354@us.oracle.com> References: <7F5B5320CDAB4337974A63C6C978386E@us.oracle.com> 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 1309656983 2972 80.91.229.12 (3 Jul 2011 01:36:23 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sun, 3 Jul 2011 01:36:23 +0000 (UTC) Cc: 6113@debbugs.gnu.org To: "'Lars Magne Ingebrigtsen'" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Jul 03 03:36:19 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 1QdBbf-0000cY-DR for geb-bug-gnu-emacs@m.gmane.org; Sun, 03 Jul 2011 03:36:19 +0200 Original-Received: from localhost ([::1]:56002 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QdBbe-0006fj-5E for geb-bug-gnu-emacs@m.gmane.org; Sat, 02 Jul 2011 21:36:18 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:37352) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QdBbP-0006fe-L3 for bug-gnu-emacs@gnu.org; Sat, 02 Jul 2011 21:36:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QdBbO-0000wO-O8 for bug-gnu-emacs@gnu.org; Sat, 02 Jul 2011 21:36:03 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:48076) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QdBbO-0000wI-LO for bug-gnu-emacs@gnu.org; Sat, 02 Jul 2011 21:36:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1QdBbO-0000dx-5D; Sat, 02 Jul 2011 21:36:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 03 Jul 2011 01:36:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 6113 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 6113-submit@debbugs.gnu.org id=B6113.13096569172421 (code B ref 6113); Sun, 03 Jul 2011 01:36:02 +0000 Original-Received: (at 6113) by debbugs.gnu.org; 3 Jul 2011 01:35:17 +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 1QdBaf-0000d0-2k for submit@debbugs.gnu.org; Sat, 02 Jul 2011 21:35:17 -0400 Original-Received: from rcsinet15.oracle.com ([148.87.113.117]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QdBad-0000cp-ID for 6113@debbugs.gnu.org; Sat, 02 Jul 2011 21:35:15 -0400 Original-Received: from rtcsinet21.oracle.com (rtcsinet21.oracle.com [66.248.204.29]) by rcsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id p631Z7XO026733 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sun, 3 Jul 2011 01:35:09 GMT Original-Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by rtcsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id p631Z6QR026260 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Sun, 3 Jul 2011 01:35:07 GMT Original-Received: from abhmt115.oracle.com (abhmt115.oracle.com [141.146.116.67]) by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id p631Z1kh025144; Sat, 2 Jul 2011 20:35:01 -0500 Original-Received: from dradamslap1 (/10.159.33.69) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sat, 02 Jul 2011 18:35:00 -0700 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: Thread-Index: Acw5FRI9rHLBmEJ/ReaUUIDD6Q8QigAC6SsA X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6109 X-Source-IP: rtcsinet21.oracle.com [66.248.204.29] X-CT-RefId: str=0001.0A090201.4E0FC74D.0177:SCFSTAT5015188, ss=1, re=-4.000, fgs=0 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Sat, 02 Jul 2011 21:36:02 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) 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:47802 Archived-At: > > The description of attribute :box does not say what the > > possible values > > of :line-width are or what they mean. > > > > Take a look at face `mode-line-inactive', for instance. It has a > > `line-width' of -1. There is no way to understand this unless it is > > documented properly. Even for positive values, we say nothing about > > what the width units are (e.g. pixels). > > I don't think the units need clarification, really -- I think all the > width/height things when talking about faces would naturally > be assumed to be pixels. The question is not what you would assume the units to be. Please just state what the units are. A user will not necessarily assume anything about the units. They could be points or anything else. It doesn't take much to tell users what they are. You need only add two words: "in pixels". Search for "pixel" in the manual and you will see that this is standard procedure. It is normal for doc to tell users what the units of measurements or quantities are.