From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: reader@newsguy.com Newsgroups: gmane.emacs.help Subject: Re: Emacs manual URL citations for use in mail Date: Fri, 13 Jun 2008 07:30:39 -0500 Organization: Still searching... Message-ID: <87r6b1ldow.fsf@newsguy.com> References: <87r6b3gb8b.fsf@newsguy.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1213360507 7981 80.91.229.12 (13 Jun 2008 12:35:07 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 13 Jun 2008 12:35:07 +0000 (UTC) To: help-gnu-emacs@gnu.org Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Fri Jun 13 14:35:50 2008 Return-path: Envelope-to: geh-help-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1K78VQ-0000uf-C5 for geh-help-gnu-emacs@m.gmane.org; Fri, 13 Jun 2008 14:35:48 +0200 Original-Received: from localhost ([127.0.0.1]:43112 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1K78Uc-0004rJ-C3 for geh-help-gnu-emacs@m.gmane.org; Fri, 13 Jun 2008 08:34:58 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1K78Qk-0001m0-Fs for help-gnu-emacs@gnu.org; Fri, 13 Jun 2008 08:30:58 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1K78Qj-0001kM-BF for help-gnu-emacs@gnu.org; Fri, 13 Jun 2008 08:30:57 -0400 Original-Received: from [199.232.76.173] (port=44832 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1K78Qj-0001ju-1P for help-gnu-emacs@gnu.org; Fri, 13 Jun 2008 08:30:57 -0400 Original-Received: from main.gmane.org ([80.91.229.2]:45872 helo=ciao.gmane.org) by monty-python.gnu.org with esmtps (TLS-1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1K78Qi-0006bW-Ja for help-gnu-emacs@gnu.org; Fri, 13 Jun 2008 08:30:57 -0400 Original-Received: from list by ciao.gmane.org with local (Exim 4.43) id 1K78Qd-0007qb-OX for help-gnu-emacs@gnu.org; Fri, 13 Jun 2008 12:30:51 +0000 Original-Received: from c-67-162-73-42.hsd1.il.comcast.net ([67.162.73.42]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Fri, 13 Jun 2008 12:30:51 +0000 Original-Received: from reader by c-67-162-73-42.hsd1.il.comcast.net with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Fri, 13 Jun 2008 12:30:51 +0000 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 82 Original-X-Complaints-To: usenet@ger.gmane.org X-Gmane-NNTP-Posting-Host: c-67-162-73-42.hsd1.il.comcast.net User-Agent: Gnus/5.110011 (No Gnus v0.11) Emacs/22.2 (gnu/linux) Cancel-Lock: sha1:r0RSOQHksdZ6MSBmokhPsf56CC8= X-detected-kernel: by monty-python.gnu.org: Linux 2.6, seldom 2.4 (older, 4) X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.help:54790 Archived-At: Reiner Steib writes: > On Wed, Jun 11 2008, reader@newsguy.com wrote: > >> I know there is a format one can use to cite a section of the emacs >> manual inside mail or a post, but could not find that format in the >> emacs manual with a few (possibly badly aimed) regex searches. > > Does this help? > > ,----[ f rs-info-insert-current-node RET ] > | rs-info-insert-current-node is an interactive Lisp function in `rs-info'. > | (rs-info-insert-current-node style &optional noinsert) > | > | Insert reference to current Info node using style in buffer. > | > | If noinsert (the prefix), return the string instead. > | > | Possible styles (must be a symbol): > | - `emacs' (Emacs style): (info "(file)node") > | - `emacs-press': as `emacs' plus a note about `C-x C-e' > | - `emacs-keys-goto' (Emacs key sequence): `C-h i g (file)node RET' > | - `emacs-keys-menu' (Emacs menu key sequence): `C-h i d m file RET m node RET' > | - `custom-manual': ":link '(custom-manual "(file)node")" for `defcustom' > | - `info-link': ":link '(info-link "(file)node")" for `defcustom' > | - `texinfo-ref-full': A full "@ref{...}" for Texinfo > | - `texinfo-ref': "@ref{...}" for Texinfo within the same file > | - `gnus' (the Gnus home brewed style): (deprecated) > | - `gnome' (GNOME style): > | - `kde' (KDE style): > | - `konqueror' (Konqueror style): > | > | When used interactively, the default is taken from `rs-info-style-alist'. > | > | For `emacs' and `emacs-press' style see the variable > | `rs-info-goto-node-string'. > `---- > > See: > ;; rs-info.el -- Some info related functions > ;; Author: Reiner Steib > ;; Keywords: info > ;; X-URL: http://theotp1.physik.uni-ulm.de/~ste/comp/emacs/misc/rs-info.el Reiner, thanks.. lots of info there... sorry to be so dense but I'm still not getting how these urls are generated. Is it only done manually? That is, one simply types out the url (info "(file)node") By reading the top of an info page? Trying a few of those using something like: M-x rs-info-insert-current-node or M-x rs-info-goto-node-string Just shows no-match while inside info. Evans Winner writes: > reader@newsguy.com writes: > > I know there is a format one can use to cite a section > of the emacs manual inside mail or a post, but could not > find that format in the emacs manual with a few > (possibly badly aimed) regex searches. > > Can someone aim me at the section that describes the > format of those URL type citations of the m? > > I am not sure about a reference to that, but maybe you mean > things like this -- > > (info "(cl)Assertions") > > -- which can be evaluated inside Emacs and will start info > in the ``cl'' section, in the subsection ``Assertions,'' for > instance. It is sort of an odd syntax, I suppose. Yes, thats the one. Can that be generated somehow or do we have to type it out while referencing those elements on the top of an info page?