Package: asciidoc / 8.6.9-5

enhance_asciidoc_manpage.patch Patch series | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
Author: Alexander Wirt <formorer@debian.org>
Description: This patch adds EXAMPLES and SEE ALSO sections to the asciidoc
--- a/doc/a2x.1.txt
+++ b/doc/a2x.1.txt
@@ -353,6 +353,11 @@
 Main web site: http://asciidoc.org/
 
 
+SEE ALSO
+--------
+asciidoc(1)
+
+
 COPYING
 -------
 Copyright \(C) 2002-2011 Stuart Rackham. Free use of this software is
--- a/doc/asciidoc.1.txt
+++ b/doc/asciidoc.1.txt
@@ -162,6 +162,25 @@
   names starting with a period are skipped.
 
 
+EXAMPLES
+--------
+`asciidoc asciidoc_file_name.txt`::
+  Simply generate an html file from the asciidoc_file_name.txt that is in
+  current directory using asciidoc.
+
+`asciidoc -b html5 asciidoc_file_name.txt`::
+  Use the `-b` switch to use one of the proposed backend or another one you
+  installed on your computer.
+
+`asciidoc -a data-uri -a icons -a toc -a max-width=55em article.txt`::
+  Use the `-a` switch to set attributes from command-line. AsciiDoc generated
+  its stand-alone HTML user guide containing embedded CSS, JavaScript and
+  images from the AsciiDoc article template with this command.
+
+`asciidoc -b html5 -d manpage asciidoc.1.txt`::
+  Generating the asciidoc manpage using the html5 backend.
+
+
 EXIT STATUS
 -----------
 *0*::
@@ -190,6 +209,11 @@
 Main web site: <http://asciidoc.org/>
 
 
+SEE ALSO
+--------
+a2x(1)
+
+
 COPYING
 -------
 Copyright \(C) 2002-2011 Stuart Rackham. Free use of this software is