Upgrade Texinfo from 4.8 to 4.13 on the vendor branch
[dragonfly.git] / contrib / texinfo / doc / info.1
1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
2 .TH INFO "1" "September 2008" "info 4.13" "User Commands"
3 .SH NAME
4 info \- read Info documents
5 .SH SYNOPSIS
6 .B info
7 [\fIOPTION\fR]... [\fIMENU-ITEM\fR...]
8 .SH DESCRIPTION
9 Read documentation in Info format.
10 .SH OPTIONS
11 .TP
12 \fB\-k\fR, \fB\-\-apropos\fR=\fISTRING\fR
13 look up STRING in all indices of all manuals.
14 .TP
15 \fB\-d\fR, \fB\-\-directory\fR=\fIDIR\fR
16 add DIR to INFOPATH.
17 .TP
18 \fB\-\-dribble\fR=\fIFILENAME\fR
19 remember user keystrokes in FILENAME.
20 .TP
21 \fB\-f\fR, \fB\-\-file\fR=\fIFILENAME\fR
22 specify Info file to visit.
23 .TP
24 \fB\-h\fR, \fB\-\-help\fR
25 display this help and exit.
26 .TP
27 \fB\-\-index\-search\fR=\fISTRING\fR
28 go to node pointed by index entry STRING.
29 .TP
30 \fB\-n\fR, \fB\-\-node\fR=\fINODENAME\fR
31 specify nodes in first visited Info file.
32 .TP
33 \fB\-o\fR, \fB\-\-output\fR=\fIFILENAME\fR
34 output selected nodes to FILENAME.
35 .TP
36 \fB\-R\fR, \fB\-\-raw\-escapes\fR
37 output "raw" ANSI escapes (default).
38 .TP
39 \fB\-\-no\-raw\-escapes\fR
40 output escapes as literal text.
41 .TP
42 \fB\-\-restore\fR=\fIFILENAME\fR
43 read initial keystrokes from FILENAME.
44 .TP
45 \fB\-O\fR, \fB\-\-show\-options\fR, \fB\-\-usage\fR
46 go to command\-line options node.
47 .TP
48 \fB\-\-subnodes\fR
49 recursively output menu items.
50 .TP
51 \fB\-\-vi\-keys\fR
52 use vi\-like and less\-like key bindings.
53 .TP
54 \fB\-\-version\fR
55 display version information and exit.
56 .TP
57 \fB\-w\fR, \fB\-\-where\fR, \fB\-\-location\fR
58 print physical location of Info file.
59 .PP
60 The first non\-option argument, if present, is the menu entry to start from;
61 it is searched for in all `dir' files along INFOPATH.
62 If it is not present, info merges all `dir' files and shows the result.
63 Any remaining arguments are treated as the names of menu
64 items relative to the initial node visited.
65 .PP
66 For a summary of key bindings, type h within Info.
67 .SH EXAMPLES
68 .TP
69 info
70 show top\-level dir menu
71 .TP
72 info info
73 show the general manual for Info readers
74 .TP
75 info info\-stnd
76 show the manual specific to this Info program
77 .TP
78 info emacs
79 start at emacs node from top\-level dir
80 .TP
81 info emacs buffers
82 start at buffers node within emacs manual
83 .TP
84 info \fB\-\-show\-options\fR emacs
85 start at node with emacs' command line options
86 .TP
87 info \fB\-\-subnodes\fR \fB\-o\fR out.txt emacs
88 dump entire manual to out.txt
89 .TP
90 info \fB\-f\fR ./foo.info
91 show file ./foo.info, not searching dir
92 .SH "REPORTING BUGS"
93 Email bug reports to bug\-texinfo@gnu.org,
94 general questions and discussion to help\-texinfo@gnu.org.
95 Texinfo home page: http://www.gnu.org/software/texinfo/
96 .SH COPYRIGHT
97 Copyright \(co 2008 Free Software Foundation, Inc.
98 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
99 .br
100 This is free software: you are free to change and redistribute it.
101 There is NO WARRANTY, to the extent permitted by law.