Viewing File: /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.7, 23 September 2019),
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, 2017, 2018, 2019 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 no Front-Cover Texts, and with no Back-Cover
Texts.  A copy of the license is included in the section entitled
"GNU Free Documentation License". -->
<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>New Info File (GNU Texinfo 6.7)</title>

<meta name="description" content="New Info File (GNU Texinfo 6.7)">
<meta name="keywords" content="New Info File (GNU Texinfo 6.7)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="texi2any">
<link href="index.html" rel="start" title="Top">
<link href="Command-and-Variable-Index.html" 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" rel="up" title="Installing an Info File">
<link href="Other-Info-Directories.html" rel="next" title="Other Info Directories">
<link href="Directory-File.html" rel="prev" title="Directory File">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {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}
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">
<span id="New-Info-File"></span><div class="header">
<p>
Next: <a href="Other-Info-Directories.html" accesskey="n" rel="next">Other Info Directories</a>, Previous: <a href="Directory-File.html" accesskey="p" rel="prev">Directory File</a>, Up: <a href="Installing-an-Info-File.html" 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" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<span id="Listing-a-New-Info-File"></span><h4 class="subsection">21.2.2 Listing a New Info File</h4>
<span id="index-Adding-a-new-Info-file"></span>
<span id="index-Listing-a-new-Info-file"></span>
<span id="index-New-Info-file_002c-listing-it-in-dir-file"></span>
<span id="index-Info-file_002c-listing-a-new"></span>
<span id="index-dir-file-listing"></span>

<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 id="DOCF5" href="#FOOT5"><sup>5</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>

<h5><a id="FOOT5" href="#DOCF5">(5)</a></h3>
<p>On MS-DOS/MS-Windows systems, Info will
try the <samp>.inf</samp> extension as well.</p>
</div>



</body>
</html>
Back to Directory File Manager