I want to to convert Documentation/DocBook/*.tmpl files into SGML.
I have try to follow the following script but I got stuck when I run
scripts/docproc.c. I got "permission denied" error.
There is another file "docproc" in the ~/scripts directory. When I run that file I got the following message
-------------------------------------------------
Usage: docproc {doc|depend} file
Input is read from file.tmpl. Output is sent to stdout
doc: frontend when generating kernel documentation
depend: generate list of files referenced within file
---------------------------------------------------
The script as follows
-------------------------------------------------------------
I will be thankful if someone helps me out
Regards,
I have try to follow the following script but I got stuck when I run
scripts/docproc.c. I got "permission denied" error.
There is another file "docproc" in the ~/scripts directory. When I run that file I got the following message
-------------------------------------------------
Usage: docproc {doc|depend} file
Input is read from file.tmpl. Output is sent to stdout
doc: frontend when generating kernel documentation
depend: generate list of files referenced within file
---------------------------------------------------
The script as follows
-------------------------------------------------------------
1 kernel-doc nano-HOWTO---------------------------------------------------------------------------------
2 =====================
3
4 Many places in the source tree have extractable documentation in the
5 form of block comments above functions. The components of this system
6 are:
7
8 - scripts/kernel-doc
9
10 This is a perl script that hunts for the block comments and can mark
11 them up directly into DocBook, man, text, and HTML. (No, not
12 texinfo.)
13
14 - Documentation/DocBook/*.tmpl
15
16 These are SGML template files, which are normal SGML files with
17 special place-holders for where the extracted documentation should
18 go.
19
20 - scripts/docproc.c
21
22 This is a program for converting SGML template files into SGML
23 files. It invokes kernel-doc, giving it the list of functions that
24 are to be documented.
25
26 - scripts/gen-all-syms
27
28 This is a script that lists the EXPORT_SYMBOL symbols in a list of C
29 files.
30
31 - scripts/docgen
32
33 This script invokes docproc, telling it which functions are to be
34 documented (this list comes from gen-all-syms).
35
36 - Makefile
37
38 The targets 'sgmldocs', 'psdocs', 'pdfdocs', and 'htmldocs' are used
39 to build DocBook files, PostScript files, PDF files, and html files
40 in Documentation/DocBook.
41
42 - Documentation/DocBook/Makefile
43
44 This is where C files are associated with SGML templates.
I will be thankful if someone helps me out
Regards,
Send instant messages to your online friends http://uk.messenger.yahoo.com
