From: Sean Morrison <brlcad@us...> - 2006-05-01 02:19:14
Update of /cvsroot/brlcad/brlcad/src/conv
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv31833/src/conv
update the manpage with more up-to-date information and details. mention that current format is a tcl script, that the conversion to ascii isn't strictly necessary any longer since v5 format is portable, and that the ascii format should not be used by external codes.
RCS file: /cvsroot/brlcad/brlcad/src/conv/g2asc.1,v
retrieving revision 14.6
retrieving revision 14.7
diff -w -u -r14.6 -r14.7
--- g2asc.1 18 Jan 2006 06:46:13 -0000 14.6
+++ g2asc.1 1 May 2006 02:19:04 -0000 14.7
@@ -24,7 +24,7 @@
-asc2g \- convert between binary and ASCII \fBmged\fP databases.
+asc2g \- convert between binary and ASCII \fBmged\fP geometry databases.
@@ -36,20 +36,34 @@
.IR mged (1)
database is inherently non-portable.
are simple filters which convert between
-the binary form and a portable ASCII representation.
+the binary form and an ASCII representation.
Any warning messages are written to standard error.
+The ASCII representation of BRL-CAD geometry databases is not a fixed
+format and is allowed to change without deprecation notice. In
+general, this will not occur any more frequently than the binary
+geometry database format changes, though both are open specifications.
+Regardless, the ASCII representation is subject to change without
+notice and should not be relied upon by external codes. Currently,
+the ASCII representation is a Tcl script that is parsed by a
+simplified geometry command interpreter.
are typically used to convert binary
.IR mged (1)
-files to a portable ASCII format so the files can be transferred
-to another machine. On the local machine, files are converted to ASCII using
+files to an ASCII format. This was traditionally performed so the
+files could be transferred to another machine in a portable format.
+Although no longer necessary for the current binary geometry database
+files that are created by mged ("v5" format), the g2asc conversion
+process is still necessary if manipulating older ("v4" format)
+geometry database files. On the local machine, files are converted to
.IR g2asc (1),
then transferred to the remote machine. On the remote machine, the files
are then converted back to the binary representation for that machine using
@@ -58,7 +72,7 @@
g2asc file.g file.asc
-rcp file.asc remote:file.asc
+scp file.asc remote:file.asc
rsh remote "asc2g file.asc file.g"