From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: David Kastrup Newsgroups: gmane.emacs.devel Subject: Re: On being web-friendly and why info must die Date: Sun, 07 Dec 2014 10:54:47 +0100 Organization: Organization?!? Message-ID: <87a92zn5so.fsf@fencepost.gnu.org> References: <20141205123549.GA29331@thyrsus.com> <87mw72lyzs.fsf@earlgrey.lan> <20141205190925.GA5067@thyrsus.com> <20141206061019.GC14890@thyrsus.com> <83ppbx1aag.fsf@gnu.org> <20141206110310.GE19750@thyrsus.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1417946138 25572 80.91.229.3 (7 Dec 2014 09:55:38 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 7 Dec 2014 09:55:38 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Dec 07 10:55:30 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 1XxYYs-0006Ew-La for ged-emacs-devel@m.gmane.org; Sun, 07 Dec 2014 10:55:30 +0100 Original-Received: from localhost ([::1]:57504 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XxYYs-0006uK-4J for ged-emacs-devel@m.gmane.org; Sun, 07 Dec 2014 04:55:30 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:49197) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XxYYV-0006rn-Rv for emacs-devel@gnu.org; Sun, 07 Dec 2014 04:55:13 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XxYYO-0001bQ-KQ for emacs-devel@gnu.org; Sun, 07 Dec 2014 04:55:07 -0500 Original-Received: from plane.gmane.org ([80.91.229.3]:39454) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XxYYO-0001bL-Dc for emacs-devel@gnu.org; Sun, 07 Dec 2014 04:55:00 -0500 Original-Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1XxYYN-0005yg-Jn for emacs-devel@gnu.org; Sun, 07 Dec 2014 10:54:59 +0100 Original-Received: from x2f4fd17.dyn.telefonica.de ([2.244.253.23]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Sun, 07 Dec 2014 10:54:59 +0100 Original-Received: from dak by x2f4fd17.dyn.telefonica.de with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Sun, 07 Dec 2014 10:54:59 +0100 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 32 Original-X-Complaints-To: usenet@ger.gmane.org X-Gmane-NNTP-Posting-Host: x2f4fd17.dyn.telefonica.de X-Face: 2FEFf>]>q>2iw=B6, xrUubRI>pR&Ml9=ao@P@i)L:\urd*t9M~y1^:+Y]'C0~{mAl`oQuAl \!3KEIp?*w`|bL5qr,H)LFO6Q=qx~iH4DN; i"; /yuIsqbLLCh/!U#X[S~(5eZ41to5f%E@'ELIi$t^ Vc\LWP@J5p^rst0+('>Er0=^1{]M9!p?&:\z]|;&=NP3AhB!B_bi^]Pfkw User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) Cancel-Lock: sha1:BGL1EH0PgNUVChRLfMhiFQPp7V0= X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 80.91.229.3 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:179253 Archived-At: Richard Stallman writes: > [[[ 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. ]]] > > > > And also because the index-searching commands, without which you are > > > lost in a large manual, don't exist in the Web browsers out there. > > > This is not at *all* hard to solve. I have written HTML generators > > that produce index links myself in different contexts. > > With Texinfo, we specify which items to index in each node or place, > with commands such as @cindex and @findex and @vindex. > > When you talking about "produce index links", what does that mean > concretely? What input in asciidoc would control the index? There are indexterm: ... commands for this. However, they somewhat defeat the basic principle that AsciiDoc is supposed to be its own plain text output since the indexing information is not relevant for reading the text. Consequently, the documentation states that those commands only make sense if you intend to create DocBook markup, namely go through further processing (that might, through a2x, even be used for generating "stripped" plain text). -- David Kastrup