Skip to content

Updated to implement the original wishes in the README (escaping and … #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
waltje wants to merge 3 commits into
base: master
Choose a base branch
from
Open

Updated to implement the original wishes in the README (escaping and … #2

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
17df87f
Updated to implement the original wishes in the README (escaping and …
waltje Apr 14, 2023
04fc8ff
Updated formatting of README.md.
waltje Apr 14, 2023
f6c18c2
Merge branch 'abbrev:master' into master
waltje Jan 3, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
63 changes: 49 additions & 14 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,8 +1,12 @@
Commodore 64 BASIC/PRG tools
============================
Commodore 64/128 BASIC/PRG tools
================================

This is a pair of quick-and-dirty programs I wrote originally in 2011 to
convert between a PRG file and a BAS (text) file.
convert between a PRG (tokenized) file and a BAS (text) file. Although
originally only handling the BASIC V2 keywords (Commodore 64), support
for the V3.5 (Plus/4 ?) and V7 (Commodore 128) was added. This can be
turned off by NOT defining the USE_EXTEND macro in the Makefiles.


Usage
-----
Expand All @@ -11,18 +15,47 @@ Convert a BAS file to a PRG file:

bas2prg <program.bas >program.prg

or

bas2prg -o program.prg program.bas

Convert a PRG file to a BAS file:

prg2bas <program.prg >program.bas

These programs do not take any arguments.
or

prg2bas -o program.bas program.prg

whichever format feels better.

Each program takes its own commandline options; you can see these by calling
them with the -? argument:

prg2bas -?

or

bas2prg -?


How to build
------------

Run the following command:

make
make -f unix/Makefile.GCC

or

make -f win32/Makefile.MinGW

or

make -f win32/Makefile.VC

depending on your operating system and development tools.


Layout of a BASIC PRG file
--------------------------
Expand All @@ -35,19 +68,21 @@ Layout of a BASIC PRG file
* nul byte (1 byte)
* value 0000 (2 bytes) (end of PRG)


Future directions
-----------------

These two programs have scratched my itch, so I don't plan to do anything else
with them.
with them:

It would be nice to expose the internal flags in bas2prg as command-line
arguments. It's trivial enough to edit the source code and recompile, so I
haven't put in the effort to do so.
- It would be nice to expose the internal flags in bas2prg as command-line
arguments. It's trivial enough to edit the source code and recompile, so I
haven't put in the effort to do so.

It would be nice if prg2bas would escape unprintable characters (inside
strings, for example) as hexadecimal codes inside braces (such as "{d0}"). This
would minimize problems related to differences in character sets (PETSCII vs
ASCII). It would be doubly nice if bas2prg recognized and converted these
escaped sequences properly.
- It would be nice if prg2bas would escape unprintable characters (inside
strings, for example) as hexadecimal codes inside braces (such as "{d0}").
This would minimize problems related to differences in character sets
(PETSCII vs ASCII). It would be doubly nice if bas2prg recognized and
converted these escaped sequences properly.

That said, done :)
Loading