Commit 2fa7829a by kollo

improved and updated man-pages

parent 0d1e7356
Guide to contributing to X11-Basic
==================================
X11-Basic exists for quite a while now. Therefore I consider it to be in a
quite mature state. I am planning not to extend the language much, e.g. I do
X11-Basic exists for quite a while now. Therefore I consider it to be in a
quite mature state. I am planning not to extend the language much, e.g. I do
not want to add many more commands or functions. The language as it is should
stay much the same as it is now.
......@@ -34,11 +34,13 @@ X11-Basic. Does anybody have an idea what could be the problem?
More things left to do:
=======================
- test the thing and find more bugs,
- Optimize a bit more, improve performance
- The WINDOWS-Version needs more work
- Fix the bugs
- work on the sound system
- work on the SDL-Graphics implementation (fill styles etc...)
- documentation needs more work
- find someone who can port it to apple mac/ipad/iphone
- port it to apple mac/ipad/iphone
(etc. etc.)
So you are welcome to help.
......@@ -87,6 +87,7 @@ by typing
./xbasic.static
The command-line options can be listed with the `-h' option (`./xbasic -h').
INSTALLING the standalone excecutable
=====================================
......@@ -98,8 +99,8 @@ remove the installation with
sudo make uninstall
make the pseudo-compiler work, libraries:
=========================================
make the compiler work, libraries:
===================================
If you want to use the compilers included in this package, you have to
make both the static and dynamic libraries.
......@@ -129,10 +130,6 @@ make xbcinstall
to install the compiler in /usr/local/bin/ and the compiler
man-page
After doing all this, you will also find an executabe called xbasic. This is
the interpreter, dynamically linked and much shorter than the static one.
regards and have fun
Markus Hoffmann
.TH bas2x11basic 1 19-Sep-2003 "Version 1.09" "ANSI-Basic to X11-Basic converter"
.SH NAME
bas2x11basic \- ANSI-Basic to X11-Basic converter
bas2x11basic \- ANSI-Basic to X11-Basic converter
.SH SYNOPSIS
.B bas2x11basic
.RI "[ " option " ] " <filename>
.SH DESCRIPTION
X11-Basic is a dialect of the BASIC programming language with graphics
capability that integrates features like shell scripting, cgi-Programming
and full graphical visualisation into the easy to learn basic language on
modern computers.
X11-Basic is a dialect of the BASIC programming language with graphics
capability that integrates features like shell scripting, cgi-Programming and
full graphical visualisation into the easy to learn basic language on modern
computers.
X11-Basic is a structured programming language. Structure is a
form of visual and functional encapsulation in which multipleline
sections of program look and act like single units. The beginning and
end of blocks are marked by descriptive keyword delimiters. Lines within
blocks are generally indented to make the
block visible. Most important: X11-Basic does not use line numbers.
X11-Basic is a structured programming language. Structure is a form of visual
and functional encapsulation in which multipleline sections of program look and
act like single units. The beginning and end of blocks are marked by descriptive
keyword delimiters. Lines within blocks are generally indented to make the block
visible. Most important: X11-Basic does not use line numbers.
.IR bas2x11basic
can be used to make X11-Basic template programs out of ANSI basic Files.
It helps convertig old (real) Basic Programs
with line numbers and multiple commands per line to the X11-Basic structure.
Because there are so many different BASIC Version aroud, in most cases you will
have to edit these files produced manually. But most of the work will already
have been done by this converter.
can be used to make X11-Basic template programs out of ANSI basic Files. It
helps convertig old (real) Basic Programs with line numbers and multiple
commands per line to the X11-Basic structure. Because there are so many
different BASIC Version aroud, in most cases you will have to edit these files
produced manually. But most of the work will already have been done by this
converter.
.B For a desciption of the X11-basic language and Usage of the interpreter see
.I xbasic(1).
.SH Filenames
bas2x11basic processes input files with extention .bas. The default
output filename is b.bas.
bas2x11basic processes input files with extention .bas. The default output
filename is b.bas.
.SH OPTIONS
.TP
.BI "\-o " file
Place output in file \c
.I file\c
\&. This applies regardless to whatever
\&. This applies regardless to whatever
sort of output bas2x11basic is producing.
If you do not specify `\|\c
.B \-o\c
......@@ -54,8 +53,8 @@ shows version, program and other information and exits
.SS -h --help
print a short help
For detailed help and description of the implemented basic commands take a
look at the README file.
For detailed help and description of the implemented basic commands take a look
at the README file.
.SH EXAMPLES
......@@ -69,46 +68,43 @@ bas2x11basic ansibasic.bas -o newname.bas
You can find some samples of former ANSI basic programs in
.I /usr/share/doc/packages/X11Basic/examples.
.SH The ANSI Basic to X11-Basic converter
Actually this converter is not yet complete. Further improvenents may
be applied in future. Please let me know about ANSI-Basic programs which
will not be converted.
Actually this converter is not yet complete. Further improvenents may be applied
in future. Please let me know about ANSI-Basic programs which will not be
converted.
.SH VERSION
Page was created for V.1.09
.SH BUG REPORTS
If you find a bug in the ANSI Basic to X11-Basic converter, you should
report it. But first, you should make sure that it really is
a bug, and that it appears in the latest version of the
X11-Basic package that you have.
Once you have determined that a bug actually exists, mail a
bug report to kollo@users.sourceforge.net. If you have a fix,
you are welcome to mail that as well! Suggestions may
be mailed to the x11-basic mailing list on
www.sourceforge.net/projects/x11-basic or posted to the bug
tracking system.
Comments and bug reports concerning this manual page
should be directed to kollo@users.sourceforge.net.
.SH BUGS
Still some bugs
.SH BUG REPORTS
If you find a bug in the ANSI Basic to X11-Basic converter, you should report
it. But first, you should make sure that it really is a bug, and that it appears
in the latest version of the X11-Basic package that you have.
Once you have determined that a bug actually exists, mail a bug report to
kollo@users.sourceforge.net. If you have a fix, you are welcome to mail that as
well! Suggestions may be mailed to the X11-Basic bug tracking system.
Comments and bug reports concerning this manual page should be directed to
kollo@users.sourceforge.net.
.SH AUTHOR
Markus Hoffmann <kollo@users.sourceforge.net>
.SH COPYRIGHT
Copyright (C) 1997-2003 Markus Hoffmann <kollo@users.sourceforge.net>
This program is free software; you can redistribute it
and/or modify it under the terms of the GNU General Public
License as published by the Free Software Foundation;
either version 2 of the License, or (at your option) any
later version.
This program is distributed in the hope that it will be
useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the GNU General Public License for more
details.
This program is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation; either version 2 of the License, or (at your option) any later
version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.
.SH SEE ALSO
xbasic(1), xb2c(1)
.TH gui2bas 1 19-Sep-2004 "Version 1.11" "GUI-File to X11-Basic converter"
.SH NAME
gui2bas \- GUI-File to X11-Basic converter
gui2bas \- GUI-File to X11-Basic converter
.SH SYNOPSIS
.B gui2bas
.RI "[ " option " ] " <filename>
......@@ -12,16 +12,17 @@ capability that integrates features like shell scripting, cgi-Programming and
full graphical visualisation into the easy to learn basic language on modern
computers.
X11-Basic uses a Graphics User Interface which is very similar to the ATARI ST
TOS/GEM implementation. The *.gui file format, which is basically an ASCII
representation of the ATARI ST recource files (*.rsc), can be converted to
X11-Basic code, which then can handle message boxes and forms. For conversion
of ATARI ST recource files to *.gui Files see
X11-Basic uses a graphical user interface (GUI) which is very similar to the
ATARI ST TOS/GEM implementation. The *.gui file format, which is basically an
ASCII representation of the ATARI ST recource files (*.rsc), can be converted to
X11-Basic code, which then can handle message boxes and forms. For conversion of
ATARI ST recource files to *.gui Files see
.I rsc2gui(1).
.IR gui2bas
can be used to make X11-Basic template programs out of gui Files, which
represent the Object structure of the Graphical User Interface which is
represent the Object structure of the Graphical User Interface which is
implemented into X11-Basic..
.B For a desciption of the X11-basic language and usage of the interpreter see
......@@ -36,14 +37,13 @@ The generic Format of such an object is:
label: TYPE(variables)
The label is optional and gives the object a name.
Depending on TYPE of the object, one or more variables are given as a comma
separated list in brackets.
Each Object may start a block with '{' at the end of the line. Inside this block
there might be one or more objects given which then are considered as sub-objects
of the one whichopened the block. The block will be closed by a '}' in a single line.
The label is optional and gives the object a name. Depending on TYPE of the
object, one or more variables are given as a comma separated list in brackets.
Each Object may start a block with '{' at the end of the line. Inside this
block there might be one or more objects given which then are considered as
sub-objects of the one whichopened the block. The block will be closed by a '}'
in a single line.
Example:
......@@ -56,27 +56,27 @@ BOX(X=0,Y=0,W=74,H=14, FRAME=2, FRAMECOL=1, TEXTCOL=1, BGCOL=0, PATTERN=0, TEXTM
STRING(X=35,Y=4,W=7,H=1, TEXT="bis", FONT=3, JUST=2, COLOR=4209)
STRING(X=35,Y=5,W=7,H=1, TEXT="bis", FONT=3, JUST=2, COLOR=4209)
devtext: FTEXT(X=20,Y=3,W=30,H=1,COLOR=4513,FONT=3,BORDER=1,TEXT="/dev/ttyS0", PTMP="_______________________________________",PVALID="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", FLAGS=EDITABLE)
br1: FTEXT(X=20,Y=4,W=12,H=1,COLOR=4513,FONT=3,BORDER=1,TEXT="N59:00:00.00", PTMP="____________",PVALID="XXXXXXXXXXXX", FLAGS=EDITABLE)
br2: FTEXT(X=40,Y=4,W=12,H=1,COLOR=4513,FONT=3,BORDER=1,TEXT="N59:00:00.00", PTMP="____________",PVALID="XXXXXXXXXXXX", FLAGS=EDITABLE)
lon1: FTEXT(X=20,Y=5,W=13,H=1,COLOR=4513,FONT=3,BORDER=1,TEXT="E009:00:00.00", PTMP="_____________",PVALID="XXXXXXXXXXXXX", FLAGS=EDITABLE)
lon2: FTEXT(X=40,Y=5,W=13,H=1,COLOR=4513,FONT=3,BORDER=1,TEXT="E009:00:00.00", PTMP="_____________",PVALID="XXXXXXXXXXXXX", FLAGS=EDITABLE)
ok: BUTTON(X=65,Y=4,W=7,H=4, TEXT="OK", FLAGS=SELECTABLE+DEFAULT+EXIT)
cancel: BUTTON(X=65,Y=9,W=7,H=4, TEXT="CANCEL", FLAGS=SELECTABLE+EXIT+LASTOB)
br1: FTEXT(X=20,Y=4,W=12,H=1,COLOR=4513,FONT=3,BORDER=1,TEXT="N59:00:00.00", PTMP="____________",PVALID="XXXXXXXXXXXX", FLAGS=EDITABLE)
br2: FTEXT(X=40,Y=4,W=12,H=1,COLOR=4513,FONT=3,BORDER=1,TEXT="N59:00:00.00", PTMP="____________",PVALID="XXXXXXXXXXXX", FLAGS=EDITABLE)
lon1: FTEXT(X=20,Y=5,W=13,H=1,COLOR=4513,FONT=3,BORDER=1,TEXT="E009:00:00.00", PTMP="_____________",PVALID="XXXXXXXXXXXXX", FLAGS=EDITABLE)
lon2: FTEXT(X=40,Y=5,W=13,H=1,COLOR=4513,FONT=3,BORDER=1,TEXT="E009:00:00.00", PTMP="_____________",PVALID="XXXXXXXXXXXXX", FLAGS=EDITABLE)
ok: BUTTON(X=65,Y=4,W=7,H=4, TEXT="OK", FLAGS=SELECTABLE+DEFAULT+EXIT)
cancel: BUTTON(X=65,Y=9,W=7,H=4, TEXT="CANCEL", FLAGS=SELECTABLE+EXIT+LASTOB)
}
.fi
Comments are indicated by a '#' at the beginning of a line.
.SH Filenames
gui2bas processes input files with extention .gui. The default
output filename is b.bas.
gui2bas processes input files with extention .gui. The default output filename
is b.bas.
.SH OPTIONS
.TP
.BI "\-o " file
Place output in file \c
.I file\c
\&.
\&.
.Sp
If you do not specify `\|\c
......@@ -91,14 +91,14 @@ shows version, program and other information and exits
.SS -h --help
print a short help
For detailed help and description of the implemented basic commands take a
look at the README file.
For detailed help and description of the implemented basic commands take a look
at the README file.
.SH EXAMPLES
.nf
gui2bas demo.gui
produces an output file b.bas
produces an output file b.bas
.fi
......@@ -108,39 +108,33 @@ be applied in future.
.SH VERSION
Page was created for V.1.11
.SH BUG REPORTS
If you find a bug in the GUI-File to X11-Basic converter, you should
report it. But first, you should make sure that it really is
a bug, and that it appears in the latest version of the
X11-Basic package that you have.
Once you have determined that a bug actually exists, mail a
bug report to kollo@users.sourceforge.net. If you have a fix,
you are welcome to mail that as well! Suggestions may
be mailed to the x11-basic mailing list on
www.sourceforge.net/projects/x11-basic or posted to the bug
tracking system.
Comments and bug reports concerning this manual page
should be directed to kollo@users.sourceforge.net.
.SH BUGS
Still some bugs
If you find a bug in the GUI-File to X11-Basic converter, you should report it.
But first, you should make sure that it really is a bug, and that it appears in
the latest version of the X11-Basic package that you have.
Once you have determined that a bug actually exists, mail a bug report to
kollo@users.sourceforge.net. If you have a fix, you are welcome to mail that as
well! Suggestions may be mailed to the x11-basic bug tracking system.
Comments and bug reports concerning this manual page should be directed to
kollo@users.sourceforge.net.
.SH AUTHOR
Markus Hoffmann <kollo@users.sourceforge.net>
.SH COPYRIGHT
Copyright (C) 1997-2004 Markus Hoffmann <kollo@users.sourceforge.net>
This program is free software; you can redistribute it
and/or modify it under the terms of the GNU General Public
License as published by the Free Software Foundation;
either version 2 of the License, or (at your option) any
later version.
This program is distributed in the hope that it will be
useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the GNU General Public License for more
details.
This program is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation; either version 2 of the License, or (at your option) any later
version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.
.SH SEE ALSO
xbasic(1), rsc2gui(1)
.TH myzip 1 19-Sep-2005 "Version 1.01" "Lossless file compression and encryption utility"
.SH NAME
myzip, myunzip \- Lossless file compression and encryption utility
myzip, myunzip \- Lossless file compression and encryption utility
.SH SYNOPSIS
.B myzip
.RI "[ " option " ] " <filename>
......@@ -12,67 +12,55 @@ myzip, myunzip \- Lossless file compression and encryption utility
.SH DESCRIPTION
.I myzip
compresses files using the internal COMPRESS$() function of the X11-Basic
library.
Compression is
generally considerably better than that achieved by more conventional
LZ77/LZ78-based compressors, and approaches the performance of the bzip2
compressor.
An optional encryption can be applied giving a passphrase which can be as long as
up to 16 characters (corresponding to 128 Bit). For details of the encryption
algorithm see the x11basic(1) manual for ENCRYPT$().
The command-line options are deliberately very similar to
those of
library. Compression is generally considerably better than that achieved by more
conventional LZ77/LZ78-based compressors, and approaches the performance of the
bzip2 compressor.
An optional encryption can be applied giving a passphrase which can be as long
as up to 16 characters (corresponding to 128 Bit). For details of the
encryption algorithm see the x11basic(1) manual for ENCRYPT$().
The command-line options are deliberately very similar to those of
.I GNU gzip,
but they are not identical.
.I myzip
expects a list of file names to accompany the
command-line flags. Each file is replaced by a compressed version of
itself, with the name "original_name.myz".
Each compressed file
has the same modification date, permissions, and, when possible,
ownership as the corresponding original, so that these properties can
be correctly restored at decompression time. File name handling is
naive in the sense that there is no mechanism for preserving original
file names, permissions, ownerships or dates in filesystems which lack
these concepts, or have serious file name length restrictions, such as
MS-DOS.
expects a list of file names to accompany the command-line flags. Each file is
replaced by a compressed version of itself, with the name "original_name.myz".
Each compressed file has the same modification date, permissions, and, when
possible, ownership as the corresponding original, so that these properties can
be correctly restored at decompression time. File name handling is naive in the
sense that there is no mechanism for preserving original file names,
permissions, ownerships or dates in filesystems which lack these concepts, or
have serious file name length restrictions, such as MS-DOS.
.I myzip
and
.I myunzip
will by default not overwrite existing
files. If you want this to happen, specify the \-f flag.
files. If you want this to happen, specify the \-f flag.
.I myunzip
decompresses all
specified files. Files which were not created by
decompresses all specified files. Files which were not created by
.I myzip
will be detected and ignored, and a warning issued.
will be detected and ignored, and a warning issued.
Compression is always performed, even if the compressed
file is slightly
larger than the original. Files of less than about one hundred bytes
tend to get larger, since the compression mechanism has a constant
overhead in the region of 50 bytes. Random data (including the output
of most file compressors) is coded at about 8.1 bits per byte, giving
an expansion of around 1%.
Compression is always performed, even if the compressed file is slightly larger
than the original. Files of less than about one hundred bytes tend to get
larger, since the compression mechanism has a constant overhead in the region of
50 bytes. Random data (including the output of most file compressors) is coded
at about 8.1 bits per byte, giving an expansion of around 1%.
As a self-check for your protection,
.I myzip
uses 32-bit CRCs to
make sure that the decompressed version of a file is identical to the
original. This guards against corruption of the compressed data, and
against undetected bugs in
uses 32-bit CRCs to make sure that the decompressed version of a file is
identical to the original. This guards against corruption of the compressed
data, and against undetected bugs in
.I myzip
(hopefully very unlikely). The
chances of data corruption going undetected is microscopic, about one
chance in four billion for each file processed. Be aware, though, that
the check occurs upon decompression, so it can only tell you that
something is wrong. It can't help you
recover the original uncompressed
(hopefully very unlikely). The chances of data corruption going undetected is
microscopic, about one chance in four billion for each file processed. Be
aware, though, that the check occurs upon decompression, so it can only tell you
that something is wrong. It can't help you recover the original uncompressed
data.
......@@ -91,10 +79,10 @@ If you do not specify `\|\c
\&\|' (for myzip) and the original name stored in the .myz file (for myunzip)
.TP
.B \-f --force
Force overwrite of output files. Normally,
Force overwrite of output files. Normally,
.I myzip
will not overwrite
existing output files. Also forces
existing output files. Also forces
.I myzip
to break hard links
to files, which it otherwise wouldn't do.
......@@ -104,7 +92,7 @@ Keep (don't delete) input files during compression
or decompression.
.TP
.B \-q --quiet
Suppress non-essential warning messages. Messages pertaining to
Suppress non-essential warning messages. Messages pertaining to
I/O errors and other critical events will not be suppressed.
.TP
.B \-v --verbose
......@@ -118,59 +106,56 @@ shows version, program and other information and exits
.SS -h --help
print a short help
For detailed help and description of the implemented basic commands take a
look at the README file.
For detailed help and description of the implemented basic commands take a look
at the README file.
.SH EXAMPLES
.nf
myzip Example.tar
produces an output file Example.tar.myz
produces an output file Example.tar.myz
myunzip Example.tar.myz
recovers the file Example.tar
recovers the file Example.tar
.fi
.SH The lossless file compression and encryption utility
Actually this converter is not yet complete. Further improvenents may
be applied in future.
Actually this converter is not yet complete. Further improvenents may be
applied in future.
.SH VERSION
Page was created for V.1.01
.SH BUG REPORTS
If you find a bug in the Lossless file compression and encryption utility,
you should report it. But first, you should make sure that it really is
you should report it. But first, you should make sure that it really is
a bug, and that it appears in the latest version of the
X11-Basic package that you have.
Once you have determined that a bug actually exists, mail a
bug report to kollo@users.sourceforge.net. If you have a fix,
you are welcome to mail that as well! Suggestions may
be mailed to the x11-basic mailing list on
www.sourceforge.net/projects/x11-basic or posted to the bug
tracking system.
Comments and bug reports concerning this manual page
should be directed to kollo@users.sourceforge.net.
.SH BUGS
Still some bugs
Once you have determined that a bug actually exists, mail a bug report to
kollo@users.sourceforge.net. If you have a fix, you are welcome to mail that
as well! Suggestions may be mailed to the X11-Basic bug tracking system.
Comments and bug reports concerning this manual page should be directed to
kollo@users.sourceforge.net.
.SH AUTHOR
Markus Hoffmann <kollo@users.sourceforge.net>
.SH COPYRIGHT
Copyright (C) 1997-2005 Markus Hoffmann <kollo@users.sourceforge.net>
This program is free software; you can redistribute it
and/or modify it under the terms of the GNU General Public
License as published by the Free Software Foundation;
either version 2 of the License, or (at your option) any
This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2 of the License, or (at your option) any
later version.
This program is distributed in the hope that it will be
useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the GNU General Public License for more
This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
details.
.SH SEE ALSO
xbasic(1)
.TH bas2x11basic 1 19-Sep-2003 "Version 1.09" "ANSI-Basic to X11-Basic converter"
.TH bas2x11basic 1 19-Sep-2003 "Version 1.09" "ATARI/TOS Resources to X11-Basic GUI converter"
.SH NAME
bas2x11basic \- ANSI-Basic to X11-Basic converter
rsc2gui \- ATARI/TOS Resources to X11-Basic GUI converter
.SH SYNOPSIS
.B bas2x11basic
.B rsc2gui
.RI "[ " option " ] " <filename>
.SH DESCRIPTION
X11-Basic is a comprehensive non-standard Basic interpreter with full X
capability that integrates fratures like shell scripting, cgi-Programming and
full graphical visualisation into the easy to learn basic language on moden
X11-Basic is a dialect of the BASIC programming language with graphics
capability that integrates features like shell scripting, cgi-Programming and
full graphical visualisation into the easy to learn basic language on modern
computers.
X11-Basic is a structured programming language. Structure is a
form of visual and functional encapsulation in which multipleline
sections of program look and act like single units. The beginning and
end of blocks are marked by descriptive keyword delimiters. Lines within
blocks are generally indented to make the
block visible. Most important: X11-Basic does not use line numbers.
X11-Basic uses a graphical user interface (GUI) which is very similar to the
ATARI ST TOS/GEM implementation. The *.gui file format, which is basically an
ASCII representation of the ATARI ST recource files (*.rsc), can be converted to
X11-Basic code, which then can handle message boxes and forms. (see
.I gui2bas(1).
.IR bas2x11basic
can be used to make X11-Basic template programs out of ANSI basic Files.
It helps convertig old (real) Basic Programs
with line numbers and multiple commands per line to the X11-Basic structure.
Because there are so many different BASIC Version aroud, in most cases you will
have to edit these files produced manually. But most of the work will already
have been done by this converter.
.IR rsc2gui
can be used to convert ATARI ST recource files to *.gui files.
.B For a desciption of the X11-basic language and Usage of the interpreter see
.I xbasic(1).
.SH Filenames
bas2x11basic processes input files with extention .bas. The default
output filename is b.bas.
rsc2gui processes input files with extention .rsc. The default output filename
is b.gui.
.SH OPTIONS
.TP
.BI "\-o " file
Place output in file \c
.I file\c
\&. This applies regardless to whatever
sort of output bas2x11basic is producing.
\&. This applies regardless to whatever
sort of output rsc2gui is producing.
.Sp
If you do not specify `\|\c
.B \-o\c
\&\|', the default is to use
`\|\c
.B b.bas\c
.B b.gui\c
\&\|'
.SS \--version
......@@ -61,55 +53,44 @@ look at the README file.
.SH EXAMPLES
.nf
bas2x11basic ansibasic.bas
produces an output file b.bas
rsc2gui 1st_word.rsc
produces an output file b.gui
bas2x11basic ansibasic.bas -o newname.bas
produces an output file newname.bas
rsc2gui 1st_word.rsc -o newname.gui
produces an output file newname.gui
.fi
You can find some samples of former ANSI basic programs in
.I /usr/share/doc/packages/X11Basic/examples.
.SH The ANSI Basic to X11-Basic converter
Actually this converter is not yet complete. Further improvenents may
be applied in future. Please let me know about ANSI-Basic programs which
will not be converted.
.SH VERSION
Page was created for V.1.09
.SH BUG REPORTS
If you find a bug in the ANSI Basic to X11-Basic converter, you should
report it. But first, you should make sure that it really is
a bug, and that it appears in the latest version of the
X11-Basic package that you have.
Once you have determined that a bug actually exists, mail a
bug report to kollo@users.sourceforge.net. If you have a fix,
you are welcome to mail that as well! Suggestions may
be mailed to the x11-basic mailing list on
www.sourceforge.net/projects/x11-basic or posted to the bug
tracking system.
Comments and bug reports concerning this manual page
should be directed to kollo@users.sourceforge.net.
.SH BUGS
Still some bugs
.SH BUG REPORTS
If you find a bug in the ANSI Basic to X11-Basic converter, you should report
it. But first, you should make sure that it really is a bug, and that it appears
in the latest version of the X11-Basic package that you have.
Once you have determined that a bug actually exists, mail a bug report to
kollo@users.sourceforge.net. If you have a fix, you are welcome to mail that as
well! Suggestions may be mailed to the X11-Basic bug tracking system.
Comments and bug reports concerning this manual page should be directed to
kollo@users.sourceforge.net.
.SH AUTHOR
Markus Hoffmann <kollo@users.sourceforge.net>
.SH COPYRIGHT
Copyright (C) 1997-2003 Markus Hoffmann <kollo@users.sourceforge.net>
This program is free software; you can redistribute it
and/or modify it under the terms of the GNU General Public
License as published by the Free Software Foundation;
either version 2 of the License, or (at your option) any
later version.
This program is distributed in the hope that it will be
useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the GNU General Public License for more
details.
This program is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation; either version 2 of the License, or (at your option) any later
version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.
.SH SEE ALSO
xbasic(1)
.TH X11BASIC 1 21-Dec-2014 "Version 1.23" "Basic Interpreter"
.TH X11BASIC 1 21-Dec-2015 "Version 1.24" "Basic Interpreter"
.SH NAME
xbasic,x11basic,X11-Basic \- The BASIC language interpreter and shell
.SH SYNOPSIS
......@@ -12,9 +12,9 @@ capability that integrates features like shell scripting, cgi-Programming and
full graphical visualisation into the easy to learn basic language on modern
computers.
The syntax is most similar to the old GFA-Basic ATARI ST
implementation. Old GFA-programs should run with only few changes. Also
DOS/QBASIC programmers will feel comfortable.
The syntax is most similar to the old GFA-Basic ATARI ST implementation. Old
GFA-programs should run with only few changes. Also DOS/QBASIC programmers will
feel comfortable.
Ancient ANSI-Basic programs (with line numbers) can be converted to X11-Basic
with the
......@@ -24,7 +24,7 @@ program (see the man page
).
.IR xbasic
is the script interpreter. It interpretes basic command-files (programs), which
is the interpreter. It interpretes basic command-files (programs), which
usually have the extension .bas or .xbas.
It can also run in interactive mode in which case it interpretes single lines of
code, which are entered.
......@@ -52,19 +52,19 @@ print help on topic
.SS --daemon
daemon mode