texinfo-doc-nonfree 4.13a-1 / usr / share / doc / texinfo / html / Inserting.html

This file is indexed.

/usr/share/doc/texinfo/html/Inserting.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
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
<html lang="en">
<head>
<title>Inserting - 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="Texinfo-Mode.html#Texinfo-Mode" title="Texinfo Mode">
<link rel="prev" href="Emacs-Editing.html#Emacs-Editing" title="Emacs Editing">
<link rel="next" href="Showing-the-Structure.html#Showing-the-Structure" title="Showing the Structure">
<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="Inserting"></a>
<p>
Next:&nbsp;<a rel="next" accesskey="n" href="Showing-the-Structure.html#Showing-the-Structure">Showing the Structure</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="Emacs-Editing.html#Emacs-Editing">Emacs Editing</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="Texinfo-Mode.html#Texinfo-Mode">Texinfo Mode</a>
<hr>
</div>

<!-- node-name,  next,  previous,  up -->
<h3 class="section">2.3 Inserting Frequently Used Commands</h3>

<p><a name="index-Inserting-frequently-used-commands-96"></a><a name="index-Frequently-used-commands_002c-inserting-97"></a><a name="index-Commands_002c-inserting-them-98"></a>
Texinfo mode provides commands to insert various frequently used
@-commands into the buffer.  You can use these commands to save
keystrokes.

  <p>The insert commands are invoked by typing <kbd>C-c</kbd> twice and then the
first letter of the @-command:

     <dl>
<dt><kbd>C-c C-c c</kbd><dt><kbd>M-x texinfo-insert-@code</kbd><dd><a name="index-texinfo_002dinsert_002d_0040_0040code-99"></a>Insert <code>@code{}</code> and put the
cursor between the braces.

     <br><dt><kbd>C-c C-c d</kbd><dt><kbd>M-x texinfo-insert-@dfn</kbd><dd><a name="index-texinfo_002dinsert_002d_0040_0040dfn-100"></a>Insert <code>@dfn{}</code> and put the
cursor between the braces.

     <br><dt><kbd>C-c C-c e</kbd><dt><kbd>M-x texinfo-insert-@end</kbd><dd><a name="index-texinfo_002dinsert_002d_0040_0040end-101"></a>Insert <code>@end</code> and attempt to insert the correct following word,
such as &lsquo;<samp><span class="samp">example</span></samp>&rsquo; or &lsquo;<samp><span class="samp">table</span></samp>&rsquo;.  (This command does not handle
nested lists correctly, but inserts the word appropriate to the
immediately preceding list.)

     <br><dt><kbd>C-c C-c i</kbd><dt><kbd>M-x texinfo-insert-@item</kbd><dd><a name="index-texinfo_002dinsert_002d_0040_0040item-102"></a>Insert <code>@item</code> and put the
cursor at the beginning of the next line.

     <br><dt><kbd>C-c C-c k</kbd><dt><kbd>M-x texinfo-insert-@kbd</kbd><dd><a name="index-texinfo_002dinsert_002d_0040_0040kbd-103"></a>Insert <code>@kbd{}</code> and put the
cursor between the braces.

     <br><dt><kbd>C-c C-c n</kbd><dt><kbd>M-x texinfo-insert-@node</kbd><dd><a name="index-texinfo_002dinsert_002d_0040_0040node-104"></a>Insert <code>@node</code> and a comment line
listing the sequence for the `Next',
`Previous', and `Up' nodes. 
Leave point after the <code>@node</code>.

     <br><dt><kbd>C-c C-c o</kbd><dt><kbd>M-x texinfo-insert-@noindent</kbd><dd><a name="index-texinfo_002dinsert_002d_0040_0040noindent-105"></a>Insert <code>@noindent</code> and put the
cursor at the beginning of the next line.

     <br><dt><kbd>C-c C-c s</kbd><dt><kbd>M-x texinfo-insert-@samp</kbd><dd><a name="index-texinfo_002dinsert_002d_0040_0040samp-106"></a>Insert <code>@samp{}</code> and put the
cursor between the braces.

     <br><dt><kbd>C-c C-c t</kbd><dt><kbd>M-x texinfo-insert-@table</kbd><dd><a name="index-texinfo_002dinsert_002d_0040_0040table-107"></a>Insert <code>@table</code> followed by a &lt;SPC&gt;
and leave the cursor after the &lt;SPC&gt;.

     <br><dt><kbd>C-c C-c v</kbd><dt><kbd>M-x texinfo-insert-@var</kbd><dd><a name="index-texinfo_002dinsert_002d_0040_0040var-108"></a>Insert <code>@var{}</code> and put the
cursor between the braces.

     <br><dt><kbd>C-c C-c x</kbd><dt><kbd>M-x texinfo-insert-@example</kbd><dd><a name="index-texinfo_002dinsert_002d_0040_0040example-109"></a>Insert <code>@example</code> and put the
cursor at the beginning of the next line.

     <!-- M-@{  was the binding for texinfo-insert-braces; -->
     <!-- in Emacs 19, backward-paragraph will take this binding. -->
     <br><dt><kbd>C-c C-c {</kbd><dt><kbd>M-x texinfo-insert-braces</kbd><dd><a name="index-texinfo_002dinsert_002dbraces-110"></a>Insert <code>{}</code> and put the cursor between the braces.

     <br><dt><kbd>C-c }</kbd><dt><kbd>C-c  ]</kbd><dt><kbd>M-x up-list</kbd><dd><a name="index-up_002dlist-111"></a>Move from between a pair of braces forward past the closing brace. 
Typing <kbd>C-c ]</kbd> is easier than typing <kbd>C-c }</kbd>, which
is, however, more mnemonic; hence the two keybindings.  (Also, you can
move out from between braces by typing <kbd>C-f</kbd>.) 
</dl>

  <p>To put a command such as <code>@code{...}</code><!-- /@w --> around an
<em>existing</em> word, position the cursor in front of the word and type
<kbd>C-u 1 C-c C-c c</kbd>.  This makes it easy to edit existing plain text. 
The value of the prefix argument tells Emacs how many words following
point to include between braces&mdash;&lsquo;<samp><span class="samp">1</span></samp>&rsquo; for one word, &lsquo;<samp><span class="samp">2</span></samp>&rsquo; for
two words, and so on.  Use a negative argument to enclose the previous
word or words.  If you do not specify a prefix argument, Emacs inserts
the @-command string and positions the cursor between the braces.  This
feature works only for those @-commands that operate on a word or words
within one line, such as <code>@kbd</code> and <code>@var</code>.

  <p>This set of insert commands was created after analyzing the frequency
with which different @-commands are used in the <cite>GNU Emacs
Manual</cite> and the <cite>GDB Manual</cite>.  If you wish to add your own insert
commands, you can bind a keyboard macro to a key, use abbreviations,
or extend the code in <samp><span class="file">texinfo.el</span></samp>.

  <p><a name="index-texinfo_002dstart_002dmenu_002ddescription-112"></a><a name="index-Menu-description_002c-start-113"></a><a name="index-Description-for-menu_002c-start-114"></a><kbd>C-c C-c C-d</kbd> (<code>texinfo-start-menu-description</code>) is an insert
command that works differently from the other insert commands.  It
inserts a node's section or chapter title in the space for the
description in a menu entry line.  (A menu entry has three parts, the
entry name, the node name, and the description.  Only the node name is
required, but a description helps explain what the node is about. 
See <a href="Menu-Parts.html#Menu-Parts">The Parts of a Menu</a>.)

  <p>To use <code>texinfo-start-menu-description</code>, position point in a menu
entry line and type <kbd>C-c C-c C-d</kbd>.  The command looks for and copies
the title that goes with the node name, and inserts the title as a
description; it positions point at beginning of the inserted text so you
can edit it.  The function does not insert the title if the menu entry
line already contains a description.

  <p>This command is only an aid to writing descriptions; it does not do the
whole job.  You must edit the inserted text since a title tends to use
the same words as a node name but a useful description uses different
words.

  </body></html>

APT Browse - Built by Thomas Orozco.