Page MenuHomeFreeBSD
Files F157274881

D27386.id80083.diff
No OneTemporary
Actions

D27386.id80083.diff
View Options

Index: head/en_US.ISO8859-1/books/fdp-primer/manpages/chapter.xml
===================================================================
--- head/en_US.ISO8859-1/books/fdp-primer/manpages/chapter.xml
+++ head/en_US.ISO8859-1/books/fdp-primer/manpages/chapter.xml
@@ -115,21 +115,6 @@
including PostScript for printing or <acronym>PDF</acronym>
generation. See &man.man.1;.</para>
- <tip>
- <para>Testing a new manual page can be challenging when it is
- not located in the normal manual page search path.
- &man.man.1; also does not look in the current directory. If
- the new manual page is in the current directory, prefix
- the filename with a <literal>./</literal>:</para>
-
- <screen>&prompt.user; <userinput>man ./mynewmanpage.8</userinput></screen>
-
- <para>An absolute path can also be used:</para>
-
- <screen>&prompt.user; <userinput>man /home/xsmith/mynewmanpage.8</userinput></screen>
- </tip>
-
-
<sect2 xml:id="manpages-markup-sections">
<title>Manual Page Sections</title>
@@ -643,6 +628,49 @@
.Sh AUTHORS
.An Firstname Lastname Aq Mt flastname@example.com</programlisting>
</sect2>
+ </sect1>
+
+ <sect1 xml:id="manpages-testing">
+ <title>Testing</title>
+
+ <para>Testing a new manual page can be challenging. Fortunately
+ there are some tools that can assist in the task. Some of them,
+ like &man.man.1;, do not look in the current directory. It is a
+ good idea to prefix the filename with <literal>./</literal> if
+ the new manual page is in the current directory. An absolute
+ path can also be used.</para>
+ <para>Use &man.mandoc.1;'s linter to check for parsing
+ errors:</para>
+
+ <screen>&prompt.user; <userinput>mandoc -T lint ./mynewmanpage.8</userinput></screen>
+
+ <para>Use <package>textproc/igor</package> to proofread the
+ manual page:</para>
+
+ <screen>&prompt.user; <userinput>igor ./mynewmanpage.8</userinput></screen>
+
+ <para>Use &man.man.1; to check the final result of your
+ changes:</para>
+
+ <screen>&prompt.user; <userinput>man ./mynewmanpage.8</userinput></screen>
+
+ <para>You can use &man.col.1; to filter the output of
+ &man.man.1; and get rid of the backspaces characters before
+ loading the result in your favorite editor for
+ spell checking:</para>
+
+ <screen>&prompt.user; <userinput>man ./mynewmanpage.8 | col -b | vim -R -</userinput></screen>
+
+ <para>Spell-checking with fully-featured dictionaries is
+ encouraged, and can be accomplished by using
+ <package>textproc/hunspell</package> or
+ <package>textproc/aspell</package> combined with
+ <package>textproc/en-hunspell</package> or
+ <package>textproc/en-aspell</package>, respectively.
+ For instance:</para>
+
+ <screen>&prompt.user; <userinput>aspell check --lang=en --mode=nroff ./mynewmanpage.8</userinput></screen>
+
</sect1>
<sect1 xml:id="manpages-examples-as-templates">

File Metadata

Mime Type
text/plain
Expires
Wed, May 20, 10:48 PM (3 h, 47 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
33360745
Default Alt Text
D27386.id80083.diff (2 KB)

Event Timeline