| 1 |
00README. |
00README. |
| 2 |
Created by Laurence Finston Wed Jan 14 18:33:36 CET 2004 |
Created by Laurence Finston Wed Jan 14 18:33:36 CET 2004 |
| 3 |
|
|
| 4 |
|
%% * Copyright and License. |
| 5 |
|
|
| 6 |
|
This file is part of GNU 3DLDF, a package for three-dimensional drawing. |
| 7 |
|
Copyright (C) 2003, 2004 The Free Software Foundation |
| 8 |
|
|
| 9 |
|
GNU 3DLDF is free software; you can redistribute it and/or modify |
| 10 |
|
it under the terms of the GNU General Public License as published by |
| 11 |
|
the Free Software Foundation; either version 2 of the License, or |
| 12 |
|
(at your option) any later version. |
| 13 |
|
|
| 14 |
|
GNU 3DLDF is distributed in the hope that it will be useful, |
| 15 |
|
but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 16 |
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 17 |
|
GNU General Public License for more details. |
| 18 |
|
|
| 19 |
|
You should have received a copy of the GNU General Public License |
| 20 |
|
along with GNU 3DLDF; if not, write to the Free Software |
| 21 |
|
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
| 22 |
|
|
| 23 |
|
GNU 3DLDF is a GNU package. |
| 24 |
|
It is part of the GNU Project of the |
| 25 |
|
Free Software Foundation |
| 26 |
|
and is published under the GNU General Public License. |
| 27 |
|
See the website http://www.gnu.org |
| 28 |
|
for more information. |
| 29 |
|
GNU 3DLDF is available for downloading from |
| 30 |
|
http://www.gnu.org/3dldf. |
| 31 |
|
It is also available from |
| 32 |
|
http://www.dante.de/software/ctan/, the Dante www-server |
| 33 |
|
and from http://wwwuser.gwgd.de/~lfinsto1, |
| 34 |
|
the author's website. |
| 35 |
|
|
| 36 |
|
Please send bug reports to bug-3dldf@gnu.org |
| 37 |
|
The mailing list help-3dldf@gnu.org is available for people to |
| 38 |
|
ask other users for help. |
| 39 |
|
The mailing list info-3dldf@gnu.org is for sending |
| 40 |
|
announcements to users. To subscribe to these mailing lists, send an |
| 41 |
|
email with ``subscribe <email-address>'' as the subject. |
| 42 |
|
|
| 43 |
|
The author can be contacted at: |
| 44 |
|
|
| 45 |
|
Laurence D. Finston |
| 46 |
|
Kreuzbergring 41 |
| 47 |
|
D-37075 Goettingen |
| 48 |
|
Germany |
| 49 |
|
|
| 50 |
|
lfinsto1@gwdg.de |
| 51 |
|
s246794@stud.uni-goettingen.de |
| 52 |
|
|
| 53 |
|
|
| 54 |
$Id$ |
$Id$ |
| 55 |
|
|
| 56 |
This file contains information for users of the pre-alpha versions |
%% * Top. |
| 57 |
numbered collectively 1.2.0.0. |
|
| 58 |
|
This file contains information for users of the pre-alpha |
| 59 |
|
versions numbered collectively 1.2.0.0. |
| 60 |
|
|
| 61 |
|
See the file `00NEWS' for general descriptions of recent |
| 62 |
|
changes. |
| 63 |
|
|
| 64 |
|
See the `./ChangeLog' files in the various directories for |
| 65 |
|
more specific descriptions. The file `./CWEB/ChangeLog' |
| 66 |
|
contains descriptions of changes and additions affecting |
| 67 |
|
program behavior. The file `./CWEB/freeze.log' contains the |
| 68 |
|
log entries for the configurations of my own sources that I |
| 69 |
|
freeze using `rcsfreeze'. These entries are usually more |
| 70 |
|
general than the entries in the `ChangeLog' file. |
| 71 |
|
|
| 72 |
|
This directory and the subdirectories `CWEB/', `DOC/' and |
| 73 |
|
`DOC/TEXINFO/' each contain a `LOGS/' subdirectory. These |
| 74 |
|
subdirectories contain the individual RCS log files for |
| 75 |
|
some or all of the files in the directory above. Only files |
| 76 |
|
for which I use RCS (Revision Control System) on my own |
| 77 |
|
system have such log files. The corresponding `ChangeLog' |
| 78 |
|
file duplicates and combines the entries from all of these |
| 79 |
|
log files. |
| 80 |
|
|
| 81 |
|
%% ** Various ways of reading from standard input. |
| 82 |
|
%% ** (and a bug that affects one of them). |
| 83 |
|
|
| 84 |
|
LDF 2004.09.19. |
| 85 |
|
|
| 86 |
|
It works to simply call `3dldf' and type in input from a shell. |
| 87 |
|
|
| 88 |
|
This also works: `cat sample0.ldf | 3dldf' |
| 89 |
|
|
| 90 |
|
This fails: `3dldf < sample0.ldf' |
| 91 |
|
When it reads `dotlabel.top("$p$", p);', it swallows the left |
| 92 |
|
parenthesis. I believe the best way to fix this is to change `yylex()' |
| 93 |
|
and `sub_yylex()' so that input is buffered. I've made a note |
| 94 |
|
to myself to do this. |
| 95 |
|
|
| 96 |
|
|
| 97 |
|
%% ** How to update your copies of the source files. |
| 98 |
|
|
| 99 |
|
LDF 2004.09.09. |
| 100 |
|
|
| 101 |
|
I don't update the snapshot file, i.e., the compressed |
| 102 |
|
archive file |
| 103 |
|
`http://savannah.gnu.org/cgi-bin/viewcvs/3dldf/3dldf/Group/SNAPSHOTS/3DLDFsnp.tar.gz' |
| 104 |
|
as often as I check modified files into the CVS repository. |
| 105 |
|
So the best way to keep your copies of the source files |
| 106 |
|
up-to-date is to use `cvs update'. Instructions for doing |
| 107 |
|
this can be found at `http://savannah.gnu.org/cvs/?group=3dldf'. |
| 108 |
|
|
| 109 |
|
If anyone would like to receive notifications per email of |
| 110 |
|
all commits to the CVS repository, please let me know, and I |
| 111 |
|
will arrange to have notifications send to the `help-3dldf' |
| 112 |
|
mailing list. |
| 113 |
|
|
| 114 |
|
%% ** Calling `3dldf'. |
| 115 |
|
|
| 116 |
|
LDF 2004.09.09. |
| 117 |
|
|
| 118 |
|
It is now possible to call `3dldf' without arguments and |
| 119 |
|
to use it interactively. It is also now possible to use it |
| 120 |
|
without the options `multithread-input' and `multithread-output'. |
| 121 |
|
|
| 122 |
|
It worked to pass multiple filename arguments to `3dldf' with |
| 123 |
|
multithreaded input and output the last time I tried it, |
| 124 |
|
but I haven't done this for awhile. I don't remember |
| 125 |
|
whether I've ever tried this without multithreaded input and output. |
| 126 |
|
|
| 127 |
|
It shouldn't be necessary to use the suffix `.ldf' for input |
| 128 |
|
files. However, it's been awhile since I tested the use of |
| 129 |
|
other suffixes, or no suffix, too. |
| 130 |
|
|
| 131 |
|
%% ** Debugging output |
| 132 |
|
|
| 133 |
|
LDF 2004.09.05. |
| 134 |
|
|
| 135 |
|
Instructions for installing 3DLDF can be found in `INSTALL'. |
| 136 |
|
Further information can be found in `README'. I have not yet |
| 137 |
|
updated the information in these files, beyond changing the |
| 138 |
|
version number of the package. However, I believe most of |
| 139 |
|
the information in them still applies. |
| 140 |
|
|
| 141 |
|
To turn off debugging output, run configure with the |
| 142 |
|
`--disable-debug-compile' option, i.e., |
| 143 |
|
|
| 144 |
|
`configure --prefix=<your path>/3DLDF-1.2.0.0/ --disable-debug-compile' |
| 145 |
|
|
| 146 |
|
Since I am uploading my actual development versions to the |
| 147 |
|
public CVS archive, running `3dldf' may otherwise cause a |
| 148 |
|
great deal of debugging output to be written to the screen |
| 149 |
|
(`stderr', to be precise). The `--disable-debug-compile' |
| 150 |
|
option causes the debugging output to not be compiled at |
| 151 |
|
all, so this is probably the best thing for people to do, |
| 152 |
|
who don't plan to ever look at the source code or run |
| 153 |
|
`3dldf' under the control of a debugger. |
| 154 |
|
|
| 155 |
|
For others who may be interested in the debugging output, |
| 156 |
|
it would be best to not use this option. Almost every |
| 157 |
|
function and all of the actions in the parser input files |
| 158 |
|
define a variable `bool DEBUG'. Setting it to `false' will |
| 159 |
|
suppress the debugging output within the scope of that |
| 160 |
|
variable. Please contact `help-3dldf@gnu.org', if you need |
| 161 |
|
more information. |
| 162 |
|
|
| 163 |
|
%% *** End of "Debugging output". |
| 164 |
|
|
| 165 |
|
|
| 166 |
|
%% * Local variables for Emacs. |
| 167 |
|
|
| 168 |
This may be needed (link): |
%% Local Variables: |
| 169 |
autom4te.cache -> /tmp/autom4te.cache |
%% mode:Fundamental |
| 170 |
|
%% eval:(outline-minor-mode t) |
| 171 |
|
%% outline-regexp:"%% *\\*+" |
| 172 |
|
%% fill-column:60 |
| 173 |
|
%% End: |