/usr/share/doc/texinfo/html/New-Info-File.html

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for GNU Texinfo (version 6.5, 25 August 2017),
a documentation system that can produce both online information and a
printed manual from a single source using semantic markup.

Copyright (C) 1988, 1990, 1991, 1992, 1993, 1995, 1996, 1997,
1998, 1999, 2001, 2001, 2003, 2004, 2005, 2006, 2007, 2008, 2009,
2010, 2011, 2012, 2013, 2014, 2015, 2016 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.3 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 have the freedom to copy and
modify this GNU manual.  Buying copies from the FSF supports it in
developing GNU and promoting software freedom." -->
<!-- Created by GNU Texinfo 6.4.90, http://www.gnu.org/software/texinfo/ -->
<head>
<title>New Info File (GNU Texinfo 6.5)</title>

<meta name="description" content="New Info File (GNU Texinfo 6.5)">
<meta name="keywords" content="New Info File (GNU Texinfo 6.5)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Command-and-Variable-Index.html#Command-and-Variable-Index" rel="index" title="Command and Variable Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Installing-an-Info-File.html#Installing-an-Info-File" rel="up" title="Installing an Info File">
<link href="Other-Info-Directories.html#Other-Info-Directories" rel="next" title="Other Info Directories">
<link href="Directory-File.html#Directory-File" rel="prev" title="Directory File">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>


</head>

<body lang="en">
<a name="New-Info-File"></a>
<div class="header">
<p>
Next: <a href="Other-Info-Directories.html#Other-Info-Directories" accesskey="n" rel="next">Other Info Directories</a>, Previous: <a href="Directory-File.html#Directory-File" accesskey="p" rel="prev">Directory File</a>, Up: <a href="Installing-an-Info-File.html#Installing-an-Info-File" accesskey="u" rel="up">Installing an Info File</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Command-and-Variable-Index.html#Command-and-Variable-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Listing-a-New-Info-File"></a>
<h4 class="subsection">21.2.2 Listing a New Info File</h4>
<a name="index-Adding-a-new-Info-file"></a>
<a name="index-Listing-a-new-Info-file"></a>
<a name="index-New-Info-file_002c-listing-it-in-dir-file"></a>
<a name="index-Info-file_002c-listing-a-new"></a>
<a name="index-dir-file-listing"></a>

<p>To add a new Info file to your system, you must write a menu entry to
add to the menu in the <samp>dir</samp> file in the <samp>info</samp> directory.
For example, if you were adding documentation for GDB, you would write
the following new entry:
</p>
<div class="example">
<pre class="example">* GDB: (gdb).           The source-level C debugger.
</pre></div>

<p>The first part of the menu entry is the menu entry name, followed by a
colon.  The second part is the name of the Info file, in parentheses,
followed by a period.  The third part is the description.
</p>
<p>The name of an Info file often has a <samp>.info</samp> extension.  Thus, the
Info file for GDB might be called either <samp>gdb</samp> or <samp>gdb.info</samp>.
The Info reader programs automatically try the file name both with and
without <samp>.info</samp><a name="DOCF6" href="#FOOT6"><sup>6</sup></a>; so it is better to avoid
clutter and not to write &lsquo;<samp>.info</samp>&rsquo; explicitly in the menu entry.  For
example, the GDB menu entry should use just &lsquo;<samp>gdb</samp>&rsquo; for the file
name, not &lsquo;<samp>gdb.info</samp>&rsquo;.
</p>

<div class="footnote">
<hr>
<h4 class="footnotes-heading">Footnotes</h4>

<h3><a name="FOOT6" href="#DOCF6">(6)</a></h3>
<p>On MS-DOS/MS-Windows systems, Info will
try the <samp>.inf</samp> extension as well.</p>
</div>



</body>
</html>
texinfo-doc-nonfree 6.5.0-1 / usr / share / doc / texinfo / html / New-Info-File.html
