/usr/share/doc/texinfo/html/Writing-a-Menu.html is in texinfo-doc-nonfree 4.13a-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 | <html lang="en">
<head>
<title>Writing a Menu - GNU Texinfo 4.13</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Texinfo 4.13">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Menus.html#Menus" title="Menus">
<link rel="prev" href="Menu-Location.html#Menu-Location" title="Menu Location">
<link rel="next" href="Menu-Parts.html#Menu-Parts" title="Menu Parts">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
This manual is for GNU Texinfo (version 4.13, 18 September 2008),
a documentation system that can produce both online information and a
printed manual from a single source.
Copyright (C) 1988, 1990, 1991, 1992, 1993, 1995, 1996, 1997,
1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008
Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License,
Version 1.2 or any later version published by the Free Software
Foundation; with no Invariant Sections, with the Front-Cover Texts
being ``A GNU Manual'', and with the Back-Cover Texts as in (a)
below. A copy of the license is included in the section entitled
``GNU Free Documentation License.''
(a) The FSF's Back-Cover Text is: ``You are free to copy and modify
this GNU Manual. Buying copies from GNU Press supports the FSF in
developing GNU and promoting software freedom.''
-->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
pre.display { font-family:inherit }
pre.format { font-family:inherit }
pre.smalldisplay { font-family:inherit; font-size:smaller }
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
span.sc { font-variant:small-caps }
span.roman { font-family:serif; font-weight:normal; }
span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<div class="node">
<a name="Writing-a-Menu"></a>
<p>
Next: <a rel="next" accesskey="n" href="Menu-Parts.html#Menu-Parts">Menu Parts</a>,
Previous: <a rel="previous" accesskey="p" href="Menu-Location.html#Menu-Location">Menu Location</a>,
Up: <a rel="up" accesskey="u" href="Menus.html#Menus">Menus</a>
<hr>
</div>
<h3 class="section">7.2 Writing a Menu</h3>
<p><a name="index-Writing-a-menu-345"></a><a name="index-Menu-writing-346"></a>
A menu consists of an <code>@menu</code> command on a line by itself
followed by menu entry lines or menu comment lines and then by an
<code>@end menu</code> command on a line by itself.
<p>A menu looks like this:
<pre class="example"> @menu
Larger Units of Text
* Files:: All about handling files.
* Multiples: Buffers. Multiple buffers; editing
several files at once.
@end menu
</pre>
<p>In a menu, every line that begins with an ‘<samp><span class="samp">* </span></samp>’<!-- /@w --> is a <dfn>menu
entry</dfn>. (Note the space after the asterisk.) A line that does not
start with an ‘<samp><span class="samp">* </span></samp>’<!-- /@w --> may also appear in a menu. Such a line is
not a menu entry but is a menu comment line that appears in the Info
file. In the example above, the line ‘<samp><span class="samp">Larger Units of Text</span></samp>’ is a
menu comment line; the two lines starting with ‘<samp><span class="samp">* </span></samp>’<!-- /@w --> are menu
<a name="index-Spaces_002c-in-menus-347"></a>entries. Space characters in a menu are preserved as-is; this allows
you to format the menu as you wish.
<p><a name="index-accesskey_0040r_007b_002c-in-HTML-output_007d-348"></a>In the HTML output from <samp><span class="command">makeinfo</span></samp>, the <code>accesskey</code>
attribute is used with the values ‘<samp><span class="samp">1</span></samp>’<small class="dots">...</small>‘<samp><span class="samp">9</span></samp>’ for the
first nine entries. This allows people using web browsers to follow
the first menu entries using (typically) <kbd>M-</kbd><var>digit</var>, e.g.,
<kbd>M-1</kbd> for the first entry.
</body></html>
|