bcpp  20210108
About: bcpp is a C(++) source code beautifier.
  Fossies Dox: bcpp-20210108.tgz  ("unofficial" and yet experimental doxygen-generated source code documentation)  

bcpp Documentation

Some Fossies usage hints in advance:

  1. To see the Doxygen generated documentation please click on one of the items in the steelblue colored "quick index" bar above or use the side panel at the left which displays a hierarchical tree-like index structure and is adjustable in width.
  2. If you want to search for something by keyword rather than browse for it you can use the client side search facility (using Javascript and DHTML) that provides live searching, i.e. the search results are presented and adapted as you type in the Search input field at the top right.
  3. Doxygen doesn't incorporate all member files but just a definable subset (basically the main project source code files that are written in a supported language). So to search and browse all member files you may visit the Fossies bcpp-20210108.tgz contents page and use the Fossies standard member browsing features (also with source code highlighting and additionally with optional code folding).
README
-- $Id: README,v 1.2 2002/11/23 13:51:29 tom Exp $
-- This is the original README - see CHANGES for a current history -TD
-------------------------------------------------------------------------------
History
-------

Version 0.9
-----------
Heaps of bugs, should never been released.

Version 1.0
-----------
Heaps of bug fixes, have tested the program heaps, and tried to
extract 98% of the errors, any bugs found while using this
program are to be considered as undocumented features.

Future Versions will include most of the limitations of version 1
fixed. I haven't fixed these yet as I'd rather have a program
that works happily instead of one that is giving me eternal
hassles (plus project dead lines). The next updated version will
be released within early December.

Version 1.5
-----------
       - Couple more bug fixes, and some code optimisation.
       
       - Unlimited (ram limited) amount of line decoding so even
         the most tangled code can be decoded (uses recursion).
         
       - Unlimited amount of single code indenting is provided 
         (fixed from last version (uses recursion))
         
       - Options for program can entered via command line, or    

         configuration file.
         
       - Operating system I/O redirection is fully support within
         the program.

       - User definable line buffer size.
       
I have tried to test this program rigorously to see that I have
no rouge pointers lying within ... (fingers crossed). Anyways it
ran fine under Qemm, and Windows (i.e. no exception errors due to
incorrect memory access). Using Qemm V7.0, the program uses DPMI
memory allocation so you the program allocate memory exceeding
640 k in MS-DOS memory model. This is done by processing large
files (i.e. 1 meg+), and using a very large buffer (i.e. 10000).
Large buffers above 10 are not really require and will slow
processing because of extensive searching (plus my Queue object
isn't the fastest of designs ever).

Version 1.55
------------

       - The only real update is working the code so that it     

         functions/compiles under Unix. 
         
       - Removed all segmentation violations.
       
       - Fixed a couple of little things ... I forget.
       
       - Input redirection under DOS fails, but works under Unix.

Version 1.6 (Final)
-------------------
This will be the final release from me of this software. This
version fixes a few more bugs, some small, some large, but I
think this time the program is about as stable as I'm going to
get it. The code will still be able to compile under both Unix,
and MS-DOS. 

     - Added a backup file feature.
     
     - Added a time feature just for the hell of it.

     - Fixed a decoding problem with quotes

     - Fixed a decoding/construction problem with tabs. The      

       current method will expand all tabs to spaces that are    

       ready via the input data stream.

Version 1.61 (User Update)
--------------------------
A Canadian programmer (Justin Slootsky) introduced a new feature
into this program that allows code that has no accompanied code
to be indented as per normal code. Although just a few lines of
code, this new feature is very effective.

Version 1.629 (Bug Update)
---------------------------
Fixed a couple of minor bugs that would cause a little havock.
Added preprocessor handling, so that any preprocessor commands are always
place at position 1;

Version 1.7 (Bug Update)
------------------------
Fixed C comment process bugs.
fixed locating configuration file (i.e uses argv[0] now) unless -fnc
switch is used.

Version 1.75 (Bug Update)
-------------------------
Fixed single statement formating over multiple lines (i.e. if, while type
statements)
Fixed a couple of simple errors that Manuel T. Petit pointed out in my
code.

Version 1.8 (Bug Of A Bug Update)
----------------------------------
This bug was created becuase of Unix's perdantic checking of memory (i.e. MNU).
I haven't checked all the conditions of a certain section of code, this caused
an 'if' statement within case structure to prematurely be trashed. The result
of which is the indent structure is removed and the code output doesn't align
correctly.




        
Util
----
Text Conversion:
I've provided a program than when compiled will convert MS-DOS
text input UNIX text using standard output, or Unix text to
MS-DOS text (OS dependant). Use this program to convert my source
so that it can be compiled without worries of carriage returns.


Compiling
---------
The only OS type system that this program has been fully tested
on is MS-DOS, so I give no guarantees that this program will
function under any other OS other then DOS. It's up to you to fix
any possible conflicts between compilers/operating systems. This
software is provided on the "As Is Where Is" bases.

Compiled using the following compilers ...

       Borland Turbo C   V1.0
       Borland Turbo C   V3.0
       GNU           G++ V1.05 (DOS)
       GNU           G++ V2.62 (UNIX)

       
Feed Back
---------     

Thanks to the few people that sent me mail pointing out my
deliberate mistakes :-) within my code/documentation. If people
use this program for other projects, I wouldn't mind hearing
about it, see DOCs for addresses.


Notices
-------
Thanks to:

        Pink Floyd (some of the best music ever written to program to)
        
        Black Jack, 8forty8, Knight Shade, Cold Shock ...
        (Some of the best heavy rock/metal bands in Hamilton/N.Z)
        
        GNU        (For producing a brilliant compiler)
        Borland    (Brilliant programming environment)