From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.devel Subject: Re: On being web-friendly and why info must die Date: Sat, 13 Dec 2014 07:47:23 -0500 Message-ID: References: <20141205123549.GA29331@thyrsus.com> <87ppbqb6s1.fsf@gnu.org> <87388mme16.fsf@newcastle.ac.uk> <87a92u86wv.fsf@gnu.org> <87egs5ktdv.fsf@newcastle.ac.uk> <548AE361.6050403@gmx.at> <87iohhj8dk.fsf@newcastle.ac.uk> Reply-To: rms@gnu.org NNTP-Posting-Host: plane.gmane.org Content-Type: text/plain; charset=ISO-8859-15 X-Trace: ger.gmane.org 1418474874 24776 80.91.229.3 (13 Dec 2014 12:47:54 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 13 Dec 2014 12:47:54 +0000 (UTC) Cc: esr@thyrsus.com, rudalics@gmx.at, ludo@gnu.org, emacs-devel@gnu.org To: phillip.lord@newcastle.ac.uk (Phillip Lord) Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Dec 13 13:47:49 2014 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 1Xzm6t-0006Gy-49 for ged-emacs-devel@m.gmane.org; Sat, 13 Dec 2014 13:47:47 +0100 Original-Received: from localhost ([::1]:32779 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xzm6s-0006gN-PW for ged-emacs-devel@m.gmane.org; Sat, 13 Dec 2014 07:47:46 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:57142) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xzm6Y-0006Z8-DR for emacs-devel@gnu.org; Sat, 13 Dec 2014 07:47:30 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Xzm6W-0002jO-Tc for emacs-devel@gnu.org; Sat, 13 Dec 2014 07:47:26 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:38011) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xzm6W-0002jC-Qy for emacs-devel@gnu.org; Sat, 13 Dec 2014 07:47:24 -0500 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.71) (envelope-from ) id 1Xzm6V-0001xw-Pm; Sat, 13 Dec 2014 07:47:23 -0500 In-reply-to: <87iohhj8dk.fsf@newcastle.ac.uk> (phillip.lord@newcastle.ac.uk) X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2001:4830:134:3::e 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:179993 Archived-At: [[[ To any NSA and FBI agents reading my email: please consider ]]] [[[ whether defending the US Constitution against all enemies, ]]] [[[ foreign or domestic, requires you to follow Snowden's example. ]]] > I meant as a pointer. So > @defdocstring{current-buffer} > would appear as > Return the current buffer as a Lisp object. > In the output format. There are two reasons we don't want to do this. 1. We want the manual text to be specified in the manual sources, not referred to some other file. 2. The text that makes a good doc string is not good for the manual. A feature to facilitate using the same text for both is inherently not a good idea. -- Dr Richard Stallman President, Free Software Foundation 51 Franklin St Boston MA 02110 USA www.fsf.org www.gnu.org Skype: No way! That's nonfree (freedom-denying) software. Use Ekiga or an ordinary phone call.