texinfo-doc-nonfree 4.13a-1 / usr / share / doc / texinfo / html / makeinfo-in-Emacs.html

This file is indexed.

/usr/share/doc/texinfo/html/makeinfo-in-Emacs.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
<html lang="en">
<head>
<title>makeinfo in Emacs - 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="Creating-an-Info-File.html#Creating-an-Info-File" title="Creating an Info File">
<link rel="prev" href="Pointer-Validation.html#Pointer-Validation" title="Pointer Validation">
<link rel="next" href="texinfo_002dformat-commands.html#texinfo_002dformat-commands" title="texinfo-format commands">
<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="makeinfo-in-Emacs"></a>
<p>
Next:&nbsp;<a rel="next" accesskey="n" href="texinfo_002dformat-commands.html#texinfo_002dformat-commands">texinfo-format commands</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="Pointer-Validation.html#Pointer-Validation">Pointer Validation</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="Creating-an-Info-File.html#Creating-an-Info-File">Creating an Info File</a>
<hr>
</div>

<h4 class="subsection">21.1.5 Running <code>makeinfo</code> Within Emacs</h4>

<p><a name="index-Running-_0040code_007bmakeinfo_007d-in-Emacs-1285"></a><a name="index-g_t_0040code_007bmakeinfo_007d-inside-Emacs-1286"></a><a name="index-Shell_002c-running-_0040code_007bmakeinfo_007d-in-1287"></a>
You can run <code>makeinfo</code> in GNU Emacs Texinfo mode by using either the
<code>makeinfo-region</code> or the <code>makeinfo-buffer</code> commands.  In
Texinfo mode, the commands are bound to <kbd>C-c C-m C-r</kbd> and <kbd>C-c
C-m C-b</kbd> by default.

     <dl>
<dt><kbd>C-c C-m C-r</kbd><dt><kbd>M-x makeinfo-region</kbd><dd>Format the current region for Info. 
<a name="index-makeinfo_002dregion-1288"></a>
<br><dt><kbd>C-c C-m C-b</kbd><dt><kbd>M-x makeinfo-buffer</kbd><dd>Format the current buffer for Info. 
<a name="index-makeinfo_002dbuffer-1289"></a></dl>

  <p>When you invoke <code>makeinfo-region</code> the output goes to a temporary
buffer.  When you invoke <code>makeinfo-buffer</code> output goes to the
file set with <code>@setfilename</code> (see <a href="setfilename.html#setfilename">setfilename</a>).

  <p>The Emacs <code>makeinfo-region</code> and <code>makeinfo-buffer</code> commands
run the <code>makeinfo</code> program in a temporary shell buffer.  If
<code>makeinfo</code> finds any errors, Emacs displays the error messages in
the temporary buffer.

  <p><a name="index-Errors_002c-parsing-1290"></a><a name="index-Parsing-errors-1291"></a><a name="index-next_002derror-1292"></a>You can parse the error messages by typing <kbd>C-x `</kbd>
(<code>next-error</code>).  This causes Emacs to go to and position the
cursor on the line in the Texinfo source that <code>makeinfo</code> thinks
caused the error.  See <a href="../emacs/Compilation.html#Compilation">Running <code>make</code> or Compilers Generally</a>, for more
information about using the <code>next-error</code> command.

  <p>In addition, you can kill the shell in which the <code>makeinfo</code>
command is running or make the shell buffer display its most recent
output.

     <dl>
<dt><kbd>C-c C-m C-k</kbd><dt><kbd>M-x makeinfo-kill-job</kbd><dd><a name="index-makeinfo_002dkill_002djob-1293"></a>Kill the current running <code>makeinfo</code> job
(from <code>makeinfo-region</code> or <code>makeinfo-buffer</code>).

     <br><dt><kbd>C-c C-m C-l</kbd><dt><kbd>M-x makeinfo-recenter-output-buffer</kbd><dd><a name="index-makeinfo_002drecenter_002doutput_002dbuffer-1294"></a>Redisplay the <code>makeinfo</code> shell buffer to display its most recent
output. 
</dl>

<p class="noindent">(Note that the parallel commands for killing and recentering a TeX
job are <kbd>C-c C-t C-k</kbd> and <kbd>C-c C-t C-l</kbd>.  See <a href="Texinfo-Mode-Printing.html#Texinfo-Mode-Printing">Texinfo Mode Printing</a>.)

  <p>You can specify options for <code>makeinfo</code> by setting the
<code>makeinfo-options</code> variable with either the <kbd>M-x
customize</kbd> or the <kbd>M-x set-variable</kbd> command, or by setting the
variable in your <samp><span class="file">.emacs</span></samp> initialization file.

  <p>For example, you could write the following in your <samp><span class="file">.emacs</span></samp> file:

<pre class="example">     (setq makeinfo-options
          "--paragraph-indent=0 --no-split
           --fill-column=70 --verbose")
</pre>
  <p class="noindent"><!-- If you write these three cross references using xref, you see -->
<!-- three references to the same named manual, which looks strange. -->
For more information, see<br>
<a href="../emacs/Easy-Customization.html#Easy-Customization">Easy Customization Interface</a>,<br>
<a href="../emacs/Examining.html#Examining">Examining and Setting Variables</a>,<br>
<a href="../emacs/Init-File.html#Init-File">Init File</a>, and<br>
<a href="makeinfo-options.html#makeinfo-options">Options for <code>makeinfo</code></a>.

  </body></html>

APT Browse - Built by Thomas Orozco.