* Standardize manpage output: program name bold, options italic/emphasized

* Make links in SEE ALSO section of manpages short without "the ... manpage"

git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@14579 91177308-0d34-0410-b5e6-96231b3b80d8

diff --git a/docs/CommandGuide/analyze.pod b/docs/CommandGuide/analyze.pod
index 3df0898760c9c503b25f6c017f6c6cc084c2f1c7..e1bbe780645a7bb71ff96bf21ee67b0d874b6364 100644 (file)
--- a/docs/CommandGuide/analyze.pod
+++ b/docs/CommandGuide/analyze.pod
@@ -1,4 +1,3 @@
-
 =pod
 
 =head1 NAME
@@ -7,7 +6,7 @@ analyze - LLVM program analyzer
 
 =head1 SYNOPSIS
 
-analyze [options] [filename]
+B<analyze> [I<options>] [I<filename>]
 
 =head1 DESCRIPTION
 
@@ -67,12 +66,10 @@ occurs, it will exit with a non-zero value.
 
 =head1 SEE ALSO
 
-L<opt>
+L<opt|opt>
 
 =head1 AUTHORS
 
 Maintained by the LLVM Team (L<http://llvm.cs.uiuc.edu>).
 
 =cut
-
-

diff --git a/docs/CommandGuide/bugpoint.pod b/docs/CommandGuide/bugpoint.pod
index acd51811263cffb270dfd697e6b3a7c2dba37cf6..7317b399024ba90373076a421aa253109ababd5e 100644 (file)
--- a/docs/CommandGuide/bugpoint.pod
+++ b/docs/CommandGuide/bugpoint.pod
@@ -6,7 +6,7 @@ bugpoint - automatic test case reduction tool
 
 =head1 SYNOPSIS
 
-bugpoint [options] [input LLVM ll/bc files] [LLVM passes] B<--args>
+B<bugpoint> [I<options>] [I<input LLVM ll/bc files>] [I<LLVM passes>] B<--args>
 I<program arguments>
 
 =head1 DESCRIPTION
@@ -240,11 +240,10 @@ if an error occurs, it will exit with a non-zero value.
 
 =head1 SEE ALSO
 
-L<opt>, L<analyze>
+L<opt|opt>, L<analyze|analyze>
 
 =head1 AUTHOR
 
 Maintained by the LLVM Team (L<http://llvm.cs.uiuc.edu>).
 
 =cut
-

diff --git a/docs/CommandGuide/extract.pod b/docs/CommandGuide/extract.pod
index e2f860eda864874feb87b23a26411f607ca4d4e4..3232d8ef21d2e78d77790c6f567b8e0051074a89 100644 (file)
--- a/docs/CommandGuide/extract.pod
+++ b/docs/CommandGuide/extract.pod
@@ -1,4 +1,3 @@
-
 =pod
 
 =head1 NAME
@@ -7,7 +6,7 @@ extract - extract a function from an LLVM module
 
 =head1 SYNOPSIS
 
-extract [options] --func function-name [filename]
+B<extract> [I<options>] B<--func> I<function-name> [I<filename>]
 
 =head1 DESCRIPTION
 
@@ -64,11 +63,10 @@ occurs, it will exit with a non-zero value.
 
 =head1 SEE ALSO
 
-L<bugpoint>
+L<bugpoint|bugpoint>
 
 =head1 AUTHORS
 
 Maintained by the LLVM Team (L<http://llvm.cs.uiuc.edu>).
 
 =cut
-

diff --git a/docs/CommandGuide/gccas.pod b/docs/CommandGuide/gccas.pod
index c5ee63b3c17b16c024b4ee69a8e709eb392a6d53..0c491a21dec3c7c89704ea5c160469f714745a57 100644 (file)
--- a/docs/CommandGuide/gccas.pod
+++ b/docs/CommandGuide/gccas.pod
@@ -1,4 +1,3 @@
-
 =pod
 
 =head1 NAME
@@ -7,7 +6,7 @@ gccas - optimizing LLVM assembler
 
 =head1 SYNOPSIS
 
-gccas [options] filename
+B<gccas> [I<options>] I<filename>
 
 =head1 DESCRIPTION
 
@@ -68,11 +67,10 @@ status.
 
 =head1 SEE ALSO
 
-L<llvm-as>, L<gccld>
+L<llvm-as|llvm-as>, L<gccld|gccld>
 
 =head1 AUTHORS
 
 Maintained by the LLVM Team (L<http://llvm.cs.uiuc.edu>).
 
 =cut
-

diff --git a/docs/CommandGuide/gccld.pod b/docs/CommandGuide/gccld.pod
index 6b0257485fe7cfcbde0771bd2157e4a0d61afb23..6accd1d7785118229f2aa5fdfbb666e26b1b840c 100644 (file)
--- a/docs/CommandGuide/gccld.pod
+++ b/docs/CommandGuide/gccld.pod
@@ -1,4 +1,3 @@
-
 =pod
 
 =head1 NAME
@@ -7,7 +6,7 @@ gccld - optimizing LLVM linker
 
 =head1 SYNOPSIS
 
-gccld [options] file1 [file2 ...]
+B<gccld> [I<options>] I<filename ...>
 
 =head1 DESCRIPTION
 
@@ -167,11 +166,10 @@ status.
 
 =head1 SEE ALSO
 
-L<llvm-link>, L<gccas>
+L<llvm-link|llvm-link>, L<gccas|gccas>
 
 =head1 AUTHORS
 
 Maintained by the LLVM Team (L<http://llvm.cs.uiuc.edu>).
 
 =cut
-

diff --git a/docs/CommandGuide/llc.pod b/docs/CommandGuide/llc.pod
index 2f812b991a5b74928c6a25b5e9e4fa79a1fe9577..71cbf1cb3a3b4b4d51074ac9728ce2cb6f88a17c 100644 (file)
--- a/docs/CommandGuide/llc.pod
+++ b/docs/CommandGuide/llc.pod
@@ -1,4 +1,3 @@
-
 =pod
 
 =head1 NAME
@@ -7,7 +6,7 @@ llc - LLVM static compiler
 
 =head1 SYNOPSIS
 
-llc [options] [filename]
+B<llc> [I<options>] [I<filename>]
 
 =head1 DESCRIPTION
 
@@ -194,11 +193,10 @@ it will exit with a non-zero value.
 
 =head1 SEE ALSO
 
-L<lli>
+L<lli|lli>
 
 =head1 AUTHORS
 
 Maintained by the LLVM Team (L<http://llvm.cs.uiuc.edu>).
 
 =cut
-

diff --git a/docs/CommandGuide/lli.pod b/docs/CommandGuide/lli.pod
index 0f1fb96b2c3a1bcbce7c97257b1b37e37e44be8d..25888c4e8576a4efc28df89a87879dc59460284e 100644 (file)
--- a/docs/CommandGuide/lli.pod
+++ b/docs/CommandGuide/lli.pod
@@ -6,15 +6,15 @@ lli - directly execute programs from LLVM bytecode
 
 =head1 SYNOPSIS
 
-lli [options] [filename] [args ...]
+B<lli> [I<options>] [I<filename>] [I<program args>]
 
 =head1 DESCRIPTION
 
-B<lli> directly executes programs in LLVM bytecode format.  It takes a program in
-LLVM bytecode format and executes it using a just-in-time compiler, if one is
-available for the current architecture, or an interpreter.  B<lli> takes
-all of the same code generator options as L<llc|llc>, but they are only effective
-when B<lli> is using the just-in-time compiler.
+B<lli> directly executes programs in LLVM bytecode format.  It takes a program
+in LLVM bytecode format and executes it using a just-in-time compiler, if one is
+available for the current architecture, or an interpreter.  B<lli> takes all of
+the same code generator options as L<llc|llc>, but they are only effective when
+B<lli> is using the just-in-time compiler.
 
 If I<filename> is not specified, then B<lli> reads the LLVM bytecode for the
 program from standard input.
@@ -67,7 +67,7 @@ Otherwise, it will return the exit code of the program it executes.
 
 =head1 SEE ALSO
 
-L<llc>
+L<llc|llc>
 
 =head1 AUTHOR
 

diff --git a/docs/CommandGuide/llvm-as.pod b/docs/CommandGuide/llvm-as.pod
index 55cfba5851d941848551645fa50ab14e7e203098..9413c0c3ea87225822d6febbaaedf6d4f1ad429d 100644 (file)
--- a/docs/CommandGuide/llvm-as.pod
+++ b/docs/CommandGuide/llvm-as.pod
@@ -6,7 +6,7 @@ llvm-as - LLVM assembler
 
 =head1 SYNOPSIS
 
-llvm-as [options] [filename]
+B<llvm-as> [I<options>] [I<filename>]
 
 =head1 DESCRIPTION
 
@@ -77,11 +77,10 @@ occurs, it will exit with a non-zero value.
 
 =head1 SEE ALSO
 
-L<llvm-dis>, L<gccas>
+L<llvm-dis|llvm-dis>, L<gccas|gccas>
 
 =head1 AUTHORS
 
 Maintained by the LLVM Team (L<http://llvm.cs.uiuc.edu>).
 
 =cut
-

diff --git a/docs/CommandGuide/llvm-bcanalyzer.pod b/docs/CommandGuide/llvm-bcanalyzer.pod
index 28a27b0e30b86b757264223a8984cb7d1e885caa..55ad323ca6dd84fad88cf62d63a23ca517a7ee89 100644 (file)
--- a/docs/CommandGuide/llvm-bcanalyzer.pod
+++ b/docs/CommandGuide/llvm-bcanalyzer.pod
@@ -6,7 +6,7 @@ llvm-bcanalyzer - LLVM bytecode analyzer
 
 =head1 SYNOPSIS
 
-llvm-bcanalyzer [options] [filename]
+B<llvm-bcanalyzer> [I<options>] [I<filename>]
 
 =head1 DESCRIPTION
 
@@ -57,7 +57,7 @@ occurs, it will exit with a non-zero value, usually 1.
 
 =head1 SEE ALSO
 
-L<llvm-dis>, L<http://llvm.cs.uiuc.edu/docs/BytecodeFormat.html>
+L<llvm-dis|llvm-dis>, L<http://llvm.cs.uiuc.edu/docs/BytecodeFormat.html>
 
 =head1 AUTHORS
 

diff --git a/docs/CommandGuide/llvm-db.pod b/docs/CommandGuide/llvm-db.pod
index 23fb4f8b0e17b59e51419a9da1b90d16f4565078..14073dd104a47ad86bca3e5d68ca3f7b351edb32 100644 (file)
--- a/docs/CommandGuide/llvm-db.pod
+++ b/docs/CommandGuide/llvm-db.pod
@@ -1,4 +1,3 @@
-
 =pod
 
 =head1 NAME
@@ -15,4 +14,3 @@ L<http://llvm.cs.uiuc.edu/docs/SourceLevelDebugging.html> in the meantime.
 Maintained by the LLVM Team (L<http://llvm.cs.uiuc.edu>).
 
 =cut
-

diff --git a/docs/CommandGuide/llvm-dis.pod b/docs/CommandGuide/llvm-dis.pod
index 1e03790e5ee2e86de3f987ff7741787d5ca3aa1c..20556fbc766e79497fb694b7f3ab835a582e26ae 100644 (file)
--- a/docs/CommandGuide/llvm-dis.pod
+++ b/docs/CommandGuide/llvm-dis.pod
@@ -6,7 +6,7 @@ llvm-dis - LLVM disassembler
 
 =head1 SYNOPSIS
 
-llvm-dis [options] [filename]
+B<llvm-dis> [I<options>] [I<filename>]
 
 =head1 DESCRIPTION
 
@@ -56,11 +56,10 @@ occurs, it will exit with a non-zero value.
 
 =head1 SEE ALSO
 
-L<llvm-as>
+L<llvm-as|llvm-as>
 
 =head1 AUTHORS
 
 Maintained by the LLVM Team (L<http://llvm.cs.uiuc.edu>).
 
 =cut
-

diff --git a/docs/CommandGuide/llvm-extract.pod b/docs/CommandGuide/llvm-extract.pod
index e2f860eda864874feb87b23a26411f607ca4d4e4..3232d8ef21d2e78d77790c6f567b8e0051074a89 100644 (file)
--- a/docs/CommandGuide/llvm-extract.pod
+++ b/docs/CommandGuide/llvm-extract.pod
@@ -1,4 +1,3 @@
-
 =pod
 
 =head1 NAME
@@ -7,7 +6,7 @@ extract - extract a function from an LLVM module
 
 =head1 SYNOPSIS
 
-extract [options] --func function-name [filename]
+B<extract> [I<options>] B<--func> I<function-name> [I<filename>]
 
 =head1 DESCRIPTION
 
@@ -64,11 +63,10 @@ occurs, it will exit with a non-zero value.
 
 =head1 SEE ALSO
 
-L<bugpoint>
+L<bugpoint|bugpoint>
 
 =head1 AUTHORS
 
 Maintained by the LLVM Team (L<http://llvm.cs.uiuc.edu>).
 
 =cut
-

diff --git a/docs/CommandGuide/llvm-link.pod b/docs/CommandGuide/llvm-link.pod
index 16a9b560c0c8fc1c9b01621c98f3960282cc656b..d7d34e271279862d69a6c8e46facf7db2e87a532 100644 (file)
--- a/docs/CommandGuide/llvm-link.pod
+++ b/docs/CommandGuide/llvm-link.pod
@@ -6,7 +6,7 @@ llvm-link - LLVM linker
 
 =head1 SYNOPSIS
 
-llvm-link [options] filename [...]
+B<llvm-link> [I<options>] I<filename ...>
 
 =head1 DESCRIPTION
 

diff --git a/docs/CommandGuide/llvm-nm.pod b/docs/CommandGuide/llvm-nm.pod
index 62080808a048c3a9c0fdc1bec2d6bbd3b1037c08..8a10405715fe22fe64a011a7deb608396933708a 100644 (file)
--- a/docs/CommandGuide/llvm-nm.pod
+++ b/docs/CommandGuide/llvm-nm.pod
@@ -6,7 +6,7 @@ llvm-nm - list LLVM bytecode file's symbol table
 
 =head1 SYNOPSIS
 
-llvm-nm [options] [filenames...]
+B<llvm-nm> [I<options>] [I<filenames...>]
 
 =head1 DESCRIPTION
 
@@ -113,11 +113,10 @@ B<llvm-nm> exits with an exit code of zero.
 
 =head1 SEE ALSO
 
-L<llvm-dis>, L<ar(1)>, L<nm(1)>
+L<llvm-dis|llvm-dis>, L<ar(1)>, L<nm(1)>
 
 =head1 AUTHOR
 
 Maintained by the LLVM Team (L<http://llvm.cs.uiuc.edu>).
 
 =cut
-

diff --git a/docs/CommandGuide/llvm-prof.pod b/docs/CommandGuide/llvm-prof.pod
index 51f44769b5eae599239ff9ba43eebec67e490244..83566f0fdeebd54b99641dc35384c1c52cbc8497 100644 (file)
--- a/docs/CommandGuide/llvm-prof.pod
+++ b/docs/CommandGuide/llvm-prof.pod
@@ -6,7 +6,7 @@ llvm-prof - print execution profile of LLVM program
 
 =head1 SYNOPSIS
 
-llvm-prof [options] [bytecode file] [llvmprof.out]
+B<llvm-prof> [I<options>] [I<bytecode file>] [I<llvmprof.out>]
 
 =head1 DESCRIPTION
 
@@ -47,12 +47,11 @@ error.
 
 =head1 EXIT STATUS
 
-B<llvm-prof> returns 1 if it cannot load the bytecode file or the profile
-information. Otherwise, it exits with zero.
+B<llvm-prof|llvm-prof> returns 1 if it cannot load the bytecode file or the
+profile information. Otherwise, it exits with zero.
 
 =head1 AUTHOR
 
 B<llvm-prof> is maintained by the LLVM Team (L<http://llvm.cs.uiuc.edu>).
 
 =cut
-

diff --git a/docs/CommandGuide/llvmgcc.pod b/docs/CommandGuide/llvmgcc.pod
index c4b553a15a061913a482d6e24bec49822d0916cd..7e4923cb2019ff1cf141a34ebaf3af7829c5088b 100644 (file)
--- a/docs/CommandGuide/llvmgcc.pod
+++ b/docs/CommandGuide/llvmgcc.pod
@@ -1,4 +1,3 @@
-
 =pod
 
 =head1 NAME
@@ -7,7 +6,7 @@ llvmgcc - LLVM C front-end
 
 =head1 SYNOPSIS
 
-llvmgcc [options] filename
+B<llvmgcc> [I<options>] I<filename>
 
 =head1 DESCRIPTION
 
@@ -78,7 +77,7 @@ occurs, it will exit with a non-zero value.
 
 =head1 SEE ALSO
 
-L<llvmg++|llvmgxx>, L<gccas>, L<gccld>
+L<llvmg++|llvmgxx>, L<gccas|gccas>, L<gccld|gccld>
 
 =head1 AUTHORS
 

diff --git a/docs/CommandGuide/llvmgxx.pod b/docs/CommandGuide/llvmgxx.pod
index b5058af3780ddbc75f7e141be3100eebee6a42b9..b29174b107f3088020e006aa717a24100522c7f8 100644 (file)
--- a/docs/CommandGuide/llvmgxx.pod
+++ b/docs/CommandGuide/llvmgxx.pod
@@ -1,4 +1,3 @@
-
 =pod
 
 =head1 NAME
@@ -7,7 +6,7 @@ llvmg++ - LLVM C++ front-end
 
 =head1 SYNOPSIS
 
-llvmg++ [options] filename
+B<llvmg++> [I<options>] I<filename>
 
 =head1 DESCRIPTION
 

diff --git a/docs/CommandGuide/opt.pod b/docs/CommandGuide/opt.pod
index bd27ec17f959648490d6b51616d3a6affa049da0..64062ec49df4eca2c7c20b6431e65c3f4a5a05d3 100644 (file)
--- a/docs/CommandGuide/opt.pod
+++ b/docs/CommandGuide/opt.pod
@@ -1,4 +1,3 @@
-
 =pod
 
 =head1 NAME
@@ -7,7 +6,7 @@ opt - LLVM optimizer
 
 =head1 SYNOPSIS
 
-opt [options] [filename]
+B<opt> [I<options>] [I<filename>]
 
 =head1 DESCRIPTION
 
@@ -89,11 +88,10 @@ occurs, it will exit with a non-zero value.
 
 =head1 SEE ALSO
 
-L<analyze>
+L<analyze|analyze>
 
 =head1 AUTHORS
 
 Maintained by the LLVM Team (L<http://llvm.cs.uiuc.edu>).
 
 =cut
-