File: NEWS

package info (click to toggle)
cxref 1.6e-3
  • links: PTS
  • area: main
  • in suites: bullseye, buster, sid
  • size: 2,996 kB
  • sloc: ansic: 16,598; yacc: 2,091; sh: 937; lex: 470; perl: 452; makefile: 433; lisp: 256; cpp: 188; python: 80
file content (418 lines) | stat: -rw-r--r-- 16,413 bytes parent folder | download | duplicates (3)
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
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
Version 1.6e of cxref released : Wed Jan 22 2014
------------------------------------------------

Bug Fixes
 Don't package up unused LSM and ANNOUNCE files.
 Pass the CPPFLAGS through to the C compiler (patch from Debian bug #665202).
 Don't crash on invalid CPP options (fixes Debian bug #715771).
 Handle the special filename that gcc-4.x uses.
 Don't crash on unparseable function declaration ("fixes" Debian bug #667443).
 Don't report line number 0 for structures/unions defined within other ones.
 Make the HTML 4.01 output use the strict DTD rather than the transitional one.
 Handle the gcc _Pragma(...) compiler directives.
 Allow gcc 4.8 to be used instead of cxref-cpp (ignore internal #defines).


Version 1.6d of cxref released : Mon Oct 3 14:00:00 2011
--------------------------------------------------------

Bug fixes
 Updated for latest version of autoconf.
 Allow structure initialisers to have multiple components (e.g. a.b=1).
 Remove gcc warning messages.
 Change Makefile for better comptibility with FreeBSD.


Version 1.6c of cxref released : Mon May 31 10:00:00 2010
---------------------------------------------------------

Bug fixes
 Handle the gcc __builtin_offsetof() and offsetof() functions.
 Check that the lex/yacc programs actually exist at configure time.
 Handle ASM statements with named identifiers in them.

Parsing changes
 Removed the char_varying type.

Document changes
 Update web page links


*NOTE* The notes for version 1.6 below apply also.


Version 1.6b of cxref released : Fri Feb 16 09:00:00 2007
---------------------------------------------------------

Bug fixes
 Define a value for PATH_MAX in case one is not already defined.
 Fix scope problem with declarations of pointers to functions.
 Remove some compilation warnings with gcc 4.


*NOTE* The notes for version 1.6 below apply also.


Version 1.6a of cxref released : Sun May 1 16:30:00 2005
--------------------------------------------------------

Bug fixes
 Added function prototypes to allow cxref-cpp to work on 64-bit machines.
 Fix bug reading from freed memory and small memory leak.
 Stop comments intended for functions appearing on #defines inside function.
 If cxref-cpp cannot find include directory from cxref-cpp.defines then abort.
 Fix installation of manual page.

Parsing changes
 Allow variable declaration in for(;;) statements.
 Allow named initialisation of structure/union using named initialisers.
 Fix bad handling of some vararg macros in cxref-cpp.


*NOTE* The notes for version 1.6 below apply also.


Version 1.6 of cxref released : Sun Sep 26 11:30:00 2004
--------------------------------------------------------

Bug fixes
 Remove unwanted </a> tag in HTML output for some variables.
 Added C99 Complex and Boolean types
 Handle a goto statement or a named label with a type name.
 Stop a structure pointer to function looking like a function declaration.

cxref-cpp changes
 Now uses gcc-2.95.3 as the base for the pre-processor.

Configure/Make changes
 Fix compilation outside of the source tree (except for example cxref docs).
 Change the directory layout by moving the source into src and READMEs into doc.

Output changes
 Removed the -html20 and -html32 options, the -html output is now version 4.01.
 Removed the -latex209 and -latex2e options, the -latex output is version 2e.
 HTML option generates a cxref stylesheet and uses it.


*NOTE* The -html[20|32] and -latex[209|2e] options have been removed, use
       -html and -latex for LaTeX 2e and HTML 4.01 format outputs.


Version 1.5g of cxref released : Sun Jun 13 09:30:00 2004
---------------------------------------------------------

Bug fixes
  New fix allowing a mix of declarations and statements in compound statements.
  Fix handling of -Afoo=bar options again.

Configure/Make changes
  Add a --without-cxref-cpp option to force using gcc instead of cxref-cpp.

cxref-cpp changes
  cxref-cpp now gets gcc defines and include path at runtime from config file.
  There is a script cxref-cpp-configure to create this configuration file.


Version 1.5f of cxref released : Sat Feb 14 15:00:00 2004
---------------------------------------------------------

Bug fixes
  Allow mixtures of variable declarations and statements in compound statements.
  Don't look for argument comment for functions with void arguments.
  Ensure that variables defined in header file and locally get comments.
  Fix the text printed for some warnings from the -warn option.
  Declaring a function as extern is the same as not declaring it local.

GCC changes
  Handle better gcc-3.x putting all of its internal #defines in the output.
  Handle gcc 3.x style options in the cxref-cpp pre-processor.
  Compile cxref-cpp if using gcc-3.x that drops comment on same line as #include.


Version 1.5e of cxref released : Sun Jun 29 10:30:00 2003
---------------------------------------------------------

Bug fixes
  Don't lose the comment or value when C++ style comments follow a #define.
  Updated to work with newer version of flex and SUN version of yacc.
  Handle references for local functions with the same name in several files.
  Remove some extra ';' from the HTML output.
  Handle macros with variable args like MACRO(a,b,...) as well as MACRO(a,b...).

GCC changes
  Handle gcc-3.x putting all of its internal #defines in the output.
  Compile cxref-cpp if using gcc-3.x that drops comment on same line as #define.


Version 1.5d of cxref released : Sun May 05 12:00:00 2002
---------------------------------------------------------

Bug fixes
  Fixes to HTML and SGML outputs (invalid character entities). Fix bug that
  stopped -R/ from working.  Fix links to HTML source files in certain cases.
  Keep the sign of negative numbers in #define output.  Improve the lex code
  (flex -s).  Add some missing ';' to yacc code.  Fix the bison debugging
  output.  Change the use of IFS in cxref-ccc script.

Configure/Make changes
  Fix Makefile to compile using non-GNU make programs.
  Add flex specific options to the Makefile if using it.
  Fixes for build/configure outside the source tree.
  Include DESTDIR in the Makefile to help installation.
  Configure makes a guess what to do with cxref-cpp if gcc is not installed.

GCC changes
  Accept the gcc-3.0 __builtin_va_list type as-if it were a valid C type.
  Handle the GCC __builtin_va_arg extension keyword.
  Handle the GCC floating point hex extension data format.
  Allow the use of gcc-3.x instead of the cxref-cpp program.


Version 1.5c of cxref released : Sat Apr 28 16:45:00 2001
---------------------------------------------------------

Bug fixes
  Better Comment handling.  Allow the __restrict keyword.  Allow bracketed
  function declarations.  Remove gcc compilation warnings.  Allow the
  configure script to be run from a different directory.

Optimisation
  Speed up the lex code.


Version 1.5b of cxref released : Sun Sep 26 10:00:00 1999
---------------------------------------------------------

Bug fixes
  Comments that use the '+html+' convention appear correctly in the HTML source
  output.  More configurable Makefile (CFLAGS and LDFLAGS options to configure).
  Increase the length of static arrays for getcwd().  Fix NAME_MAX compilation
  problem.  Fix deferencing NULL pointer problem.

Optimisation
  Speed up the cross referencing, especially for the first pass with no outputs.


Version 1.5a of cxref released : Fri Jun 18 19:15:00 1999
---------------------------------------------------------

Bug fixes
  Fix the "+html+" etc in comments.  Make verbatim comments work in LaTeX
  output.  Allow $ in function and variable names.  Allow the configure to force
  cxref-cpp instead of gcc.  Tidy the Makefiles.  Increase the size of
  statically allocated arrays in cross referencing.  Remove the problem of #line
  directives causing confusion.  Handle more GNU C extensions.  Fix references
  to the source file from the HTML.  Handle C++ comments following #defines.

Output
  The full cxref and cpp command lines are displayed as comments in output files.


Version 1.5 of cxref released : Sun Feb 21 12:00:00 1999
--------------------------------------------------------

Bug fixes
  Fix the FAQ to HTML converter.  Stop comments in header files leaking out.

Configuration
  Use the GNU autoconf program to create a configure script.
  Now uses gcc instead of cxref-cpp if it is new enough (version >= 2.8.0).
  Now compiles and runs under MS Win32 with the cygwin library.

Output
  Added SGML (Linuxdoc DTD) output.
  Added RTF (Rich Text Format) output.
  Added HTML 3.2 output (with tables).
  Added an HTML version of the source file with links into it.

Tools
  Provided a Perl script to automatically determine required header files.


*NOTE* The -html and -latex options are deprecated, use -html20 and -latex209
       for the previous functionality.


Version 1.4c of cxref not released : Sat Dec 6 14:30:00 1998
------------------------------------------------------------

Bug fixes
  Miscellaneous parsing of C source code.  Command line file/pathname parsing.
  More GNU extensions.  More support for other operating systems.  FAQ updates.


Version 1.4b of cxref released : Sat Apr 18 19:30:00 1998
---------------------------------------------------------

The patches that made it onto the cxref bug-fix web-page.
  cxref-cpp fails to compile with new Linux.  Memory hungry comment parsing.
  Missing comments on function pointer typedefs, missing directory on some
  included files.  Allow empty structure/unions to be defined.  Fix includes
  that use absolute path to subdir of -R root.

Other bugs
  Fix the install.sh program.  Added __typeof and __alignof.  Be more careful
  about the child exit status.  Improve cxref-cc error messages.

Make the comment handling a lot more memory efficient.
Ensure that there is never any memory that is not freed at the end.


Version 1.4a of cxref released : Thu Nov 20 20:30:00 1997
---------------------------------------------------------

The patches that made it onto the cxref bug-fix web-page.
  bug in -CPP option, 'volatile const' and 'const volatile' types, stopped
  crashes due to NULL pointer access, made the makefile work better on certain
  UNIX versions.

Added a -no-comments option.
Make the comment mangler better so that lines with just whitespace are emptied.

Allow blank lines and comments in the .cxref file.


Version 1.4 of cxref released : Sat Jul 5 18:30:00 1997
-------------------------------------------------------

Included a shell script to replace gcc to compile and cross-reference in one go.
Added in the option to change directory before running cxref.
Added a config file called .cxref that can contain command line arguments.

Changed the way that included variables and functions are dealt with.
  Functions and variables that are included as static or global so that they
  would be in the object file when compiled are listed as belonging to the file
  with a pointer to the header file that they were included from.

Added in a way to allow extended markup (HTML or LaTeX) inside comments.

Major re-write of the internals to increase maintainability & readability.

Added in -verbatim-comments to preserve formatting of comments in output.
Added in -block-comments to strip leading character from boxed comments.
Added an option to allow files to be deleted from the cross reference output.

Changed over to GCC V 2.7.2, reduced the patch size by moving stuff to cxref.
Added in a new command line option to pass extra arguments to the pre-processor.

Fixed the rest of the bug reports that made it onto the cxref bug-fix web-page.


Version 1.3a of cxref unreleased : Wed Apr 23 20:00:00 1997
-----------------------------------------------------------

The patches that made it onto the cxref bug-fix web-page.


Version 1.3 of cxref released : Sun Dec 8 10:30:00 1996
-------------------------------------------------------

Added manual pages for the programs.

Use the Linux Kernel source code to test the parser.
 Added more GNU C extensions.
 Fixed more errors in type names used as identifiers.

Added the ability to parse C++ comments (not for documenting).


Version 1.3-beta of cxref released : Sat Nov 16 16:30:00 1996
-------------------------------------------------------------

This is a consolidation of versions 1.2, 1.2a, 1.2b plus trivial changes.

Fixed some remaining problems with implicit integer types and type qualifiers.

HTML output conforms to HTML 2.0 standard, and passes weblint test.
HTML, LaTeX and raw outputs have ';'s added in structure defintions.

Updated FAQ, added FAQ -> html conversion script, updated README, README.html
 and README.tex, added TODO.

The cxref-cpp program now does not need machine specific hand customisation.

Improved the Makefiles to simplify the installation:
 Fully automatic configuring of cxref-cpp, all build options in a single
 Makefile configuration file, installation included.


Version 1.2b of cxref released : Sat Oct 5 13:30:00 1996
---------------------------------------------------------

Function definitions included from header files do not cause cxref to core dump.
Removed dangling cross-references for referenced vars/funcs in the output.
Function prototypes within function definitions do not cause loss of references.
Typedefs of function types now recognised when used as prototypes.
Comments for nested struct/union types now work and the output format changed.
The option -warn-xref depends on -xref, warns user if used wrongly but works OK.
The index in the cxref.html file is now always at the end in the correct place.
The LaTeX output is centred on the page correctly.

The cxref-cpp program no longer aborts on certain files in multi-directory
 source trees, and if the preprocessor does abort then cxref tidies up cleanly.

The cxref-query program no longer core dumps on certain cross-references.


Version 1.2a of cxref released : Sat Aug 17 13:00:00 1996
---------------------------------------------------------

Bug fixes in the parser for obscure C syntax:
 Type names used as identifiers, pointer to function used as a function
 argument, some K&R style function definitions, complete set of integer type
 names, more GCC extensions.


Version 1.2 of cxref released : Sat Jul  6 20:00:00 1996
--------------------------------------------------------

A FAQ is provided with common questions and answers to provide help.

Major revision of parsing code, especially for function definitions.
Labeled statements do not need a ';' (e.g. default in switch statement).
Better handling of traditional style function definitions
Variables declared extern within a function recognised and referenced.
Numerous minor bugs in parsing corrected.

Line number and file name information available in case of parse error.
Parse errors are handled gracefully, the program does not just exit.

Create sub-directories of the output directory as needed.
Better handling of include pathnames in cxref-cpp, for subdirectories.

Added a cxref.sty LaTeX style file instead of at the top of the main file.
The output files are not compatible with Version 1.1 output files.


Version 1.1 of cxref released : Wed May 22 19:00:00 1996
--------------------------------------------------------

Fixed a number of bugs in the 'front-end' of the program.

Makefile changed to make ANSI compatible latex-style.c source file.

Lexical analyser code fixed to work with a POSIX lex program.
GNU __attribute__ & __extension__ compiler directives handled better.

Better debugging options for the parser.
Bit-fields now parsed correctly and recognised as such in output.
Enum typedefs allowed to have a trailing comma.
Function definitions with no return type are now recognised as int and those
with no arguments recognised as void.
Allows the asm() GNU extension.

Fixed a problem with #include confusion with mix of global and local files.


Version 1.0 of cxref released : Sat Feb 24 16:30:00 1996
--------------------------------------------------------

A program that can automatically generate documentation and cross references for
a C program.

The input is any C program with appropriate comments and the output is LaTeX or
HTML files.

The documentation for the program is produced from comments in the code that are
appropriately formatted.  The cross referencing comes from the code itself and
requires no extra work.