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
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
|
Version 1.1:
This was the first release, so there were no changes yet.
Version 1.2:
The README in 1.1 incorrectly stated that c2man was public domain. It
is in fact copyright, but freely redistributable. See the updated
README for details.
You can use flex instead of lex now.
Comments on parameters in old-style function definitions work OK now.
Generates man pages for global variables (with -v) as well as
functions.
Major mods to parser to support comments at the end of lines; this
makes it much more tolerant about comment placement.
c2man will now parse its own source!. The manual pages it generates are
pretty bad since the comments haven't been strategically placed, but
it's better than you might expect without trying.
Rewrote a lot of the manual page to make it comprehensible.
Version 1.3:
Ignores all comments in included files, except those in enum
specifications; this should virtually eliminate trouble with errors in
files you may have no control over, like system headers.
Add "-o -" functionality to write manual pages to stdout.
Run /lib/cpp when reading from stdin too.
Rewrite comment parsing to be neater & easier to modify.
Replace -DSYSV option with its inverse -DBSD so ANSI string functions
are used by default.
enum tag/description spacing in output varies automatically.
Sprinkle output heavily with Bold for troff.
Version 1.4:
Recognise that an end-of-line comment after a function definition or
declaration applies to the last parameter of a function, so we handle:
/* try to do something that requires 2 parameters */
int try(int a, /* description of first parameter */
int b); /* description of second parameter */
Fix comment lexing problem that sometimes rejected the '# ...' lines
that cpp generates on the line immediately after a comment.
Don't capitalise n/troff dot commands.
make -V option act verbosely.
By popular demand, added -G option to group manual pages from the
same file together, ala ctype(3).
Output function prototype on a single line for all functions with one
or less parameters (ignoring -f...).
Version 1.5:
Recognise end-of-line comments after K&R style function parameters.
Specify C-preprocessor command in Makefile and add -P option to specify
a different preprocessor at runtime.
Add -g option like -G, but read the terse description from the file.
Don't disable nroff line filling in SYNOPSIS section so very long lines
still get broken.
Require a white-space after a period before capitalising the next
letter. i.e. Don't damage "i.e.".
Version 1.6:
Don't reduce pointer-to-pointers down to a single indirection level;
eg: "char **argv" got output as "char *argv". Ugh!.
Version 1.7:
Don't try to free a string constant right at the very end!.
Rename old -i option to -H, and add new -i option so user can specify
extra #include lines for the SYNOPSIS section, and prerequisites for .h
file compilation.
Work around Sun acc -E problem where .h files were ignored.
Semantic change: multiple input files all get cross-referenced in the
SEE ALSO section (or grouped together if -g or -G).
Version 1.8:
Add -lPW I'd dropped from HPUX configuration.
Fix multiple -i arguments appearing on the one line.
Version 1.9:
Fix silly missing fprintf arguments in c2man.c
Ignore trailing spaces after a comment at the end of a line.
Don't error on "typedef int NewType; NewType a;"
-Ssection option added by jerry@kesa24.kesa.com (Jerry E. Dunmire).
Version 1.10:
Accept comments around a final ellipsis parameter.
Make parameter declarations in the prototype and the PARAMETERS section
identical.
Version 2.0:
Major modifications to use Configure for easy installation.
Many, many portability fixes; converted to K&R 1 C.
Accept stdin even if preprocessor doesn't.
Don't error on: int fred() {
} /* fred */
Allow extra manual page sections not recognized by c2man.
From version 2.0 onwards, the change log for each patch is contained in the
top of the patch itself. This file is no longer updated.
|
