From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Emanuel Berg Newsgroups: gmane.emacs.help Subject: Re: info-find-source Date: Sat, 20 Jan 2018 20:49:22 +0100 Organization: Aioe.org NNTP Server Message-ID: <86mv18z4xp.fsf@zoho.com> References: <86bmhyk2qy.fsf@zoho.com> <87mv1ia0et.fsf@robertthorpeconsulting.com> <86a7xhgnag.fsf@zoho.com> <86po6beoxh.fsf@zoho.com> <86h8rmdhie.fsf@zoho.com> <861sim4903.fsf@zoho.com> <87zi59616g.fsf@mbork.pl> <86vafx1og8.fsf@zoho.com> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1516477729 25273 195.159.176.226 (20 Jan 2018 19:48:49 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sat, 20 Jan 2018 19:48:49 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.4 (gnu/linux) To: help-gnu-emacs@gnu.org Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Sat Jan 20 20:48:45 2018 Return-path: Envelope-to: geh-help-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ecz7x-0005iW-Vb for geh-help-gnu-emacs@m.gmane.org; Sat, 20 Jan 2018 20:48:34 +0100 Original-Received: from localhost ([::1]:59588 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ecz9y-00035r-9Z for geh-help-gnu-emacs@m.gmane.org; Sat, 20 Jan 2018 14:50:38 -0500 Original-Path: usenet.stanford.edu!goblin2!goblin.stu.neva.ru!aioe.org!.POSTED!not-for-mail Original-Newsgroups: gnu.emacs.help Original-Lines: 41 Original-NNTP-Posting-Host: zRXoCvQ6k9fneBfYPnB6lQ.user.gioia.aioe.org Original-X-Complaints-To: abuse@aioe.org Mail-Copies-To: never Cancel-Lock: sha1:57436YGCzPbcmgr1BwJTtndxQMc= X-Notice: Filtered by postfilter v. 0.8.2 Original-Xref: usenet.stanford.edu gnu.emacs.help:221687 X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "help-gnu-emacs" Xref: news.gmane.org gmane.emacs.help:115804 Archived-At: Drew Adams wrote: >>> This function is obsolete since 24.4; >>> editing Info nodes by hand is >>> not recommended. >> >> I've seen this as well and wondered what it >> meant... "By hand" - is the recommended way >> having a bunch of text files and have that >> compiled, or should one generate the >> documentation straight from Elisp, including >> docstrings and/or comments? > > AFAIK, the "recommended" way is to build Info > files using `makeinfo' with TexInfo source > files. Yes of course, it even says so first thing: This is slime.info, produced by makeinfo version 5.2 from slime.texi. OK, so it is the *.info files* that one is disencouraged from editing? Well yeah, why would you do that?! The "by hand" phrasing is where the confusion begins because it seems to imply there is a better way to "edit" them. But to me it seems totally backward to edit the result of compilation and I don't think I ever did that because wouldn't not only update but also recompilation overwrite the edits? In general one should edit the source! and here one could simply keep a text file with any extra material. -- underground experts united http://user.it.uu.se/~embe8573