From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: YAMAMOTO Mitsuharu Newsgroups: gmane.emacs.devel Subject: Re: x-display-pixel-width/height inconsistency Date: Thu, 09 May 2013 12:19:24 +0900 Organization: Faculty of Science, Chiba University Message-ID: References: <831ub767wf.fsf@gnu.org> <83mwtu4p7c.fsf@gnu.org> <83vc8h313t.fsf@gnu.org> <5073D6B8-95E4-4012-AA74-106F428379DC@swipnet.se> <8BD4B041-5A3F-4D7C-AFD3-E997E194AA9D@swipnet.se> <02B98FCD-71DB-47EC-B58B-41A2539FF61A@swipnet.se> <83vc6tcqss.fsf@gnu.org> <6dr4hg7wcn.fsf@fencepost.gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 (generated by SEMI 1.14.6 - "Maruoka") Content-Type: text/plain; charset=US-ASCII X-Trace: ger.gmane.org 1368069579 10902 80.91.229.3 (9 May 2013 03:19:39 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 9 May 2013 03:19:39 +0000 (UTC) Cc: Eli Zaretskii , emacs-devel@gnu.org To: Glenn Morris Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu May 09 05:19:38 2013 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1UaHOL-0005uN-4n for ged-emacs-devel@m.gmane.org; Thu, 09 May 2013 05:19:37 +0200 Original-Received: from localhost ([::1]:54599 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UaHOK-0004GZ-Nz for ged-emacs-devel@m.gmane.org; Wed, 08 May 2013 23:19:36 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:47508) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UaHOI-0004GU-4s for emacs-devel@gnu.org; Wed, 08 May 2013 23:19:34 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UaHOH-0004RK-7M for emacs-devel@gnu.org; Wed, 08 May 2013 23:19:34 -0400 Original-Received: from mathmail.math.s.chiba-u.ac.jp ([133.82.132.2]:53453) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UaHOD-0004Oa-Hw; Wed, 08 May 2013 23:19:30 -0400 Original-Received: from church.math.s.chiba-u.ac.jp (church [133.82.132.36]) by mathmail.math.s.chiba-u.ac.jp (Postfix) with ESMTP id A7038C055D; Thu, 9 May 2013 12:19:24 +0900 (JST) In-Reply-To: <6dr4hg7wcn.fsf@fencepost.gnu.org> User-Agent: Wanderlust/2.14.0 (Africa) SEMI/1.14.6 (Maruoka) FLIM/1.14.8 (=?ISO-8859-4?Q?Shij=F2?=) APEL/10.6 Emacs/22.3 (sparc-sun-solaris2.8) MULE/5.0 (SAKAKI) X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 133.82.132.2 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:159440 Archived-At: >>>>> On Wed, 08 May 2013 21:52:56 -0400, Glenn Morris said: >> I don't know how ELisp manual is usually updated. Is it supposed >> to be done by the same person who designed/implemented the new >> functions? > Hah! :) > It is _usually_ updated by a few poor souls with little-to-no > familiarity with the code in question, who have to struggle to > figure it out. > It is _supposed_ to be updated by the people who wrote the code, > (since they know it best), who should feel free to say (if > necessary) "I'm not good at documentation, please help me polish > this." > Yours only-semi-jokingly... What actually confused me was the following note in etc/NEWS: Temporary note: +++ indicates that the appropriate manual has already been updated. --- means no change in the manuals is called for. When you add a new item, please add it without either +++ or --- so we will look at it and add it to the manual. I thought the judgement whether a new feature/function needs to be documented in the maunal was done by a third person at a later time (in the pretest stage, for example). YAMAMOTO Mitsuharu mituharu@math.s.chiba-u.ac.jp