From 91bd359b45456040850b94d5f47eb28ba8a44021 Mon Sep 17 00:00:00 2001
From: "Jeroen F.J. Laros" <jlaros@fixedpoint.nl>
Date: Sun, 12 Mar 2023 15:01:27 +0100
Subject: [PATCH] Documentation.

---
 .readthedocs.yaml                            |   7 +-
 build/linux/Makefile                         |   2 +-
 doc/mzf2wavs1.gif                            | Bin 10034 -> 0 bytes
 docs/Doxyfile                                |  10 ++
 docs/api.rst                                 |  12 +++
 docs/api/methods.rst                         |   8 ++
 docs/api/mzf.rst                             |   8 ++
 docs/api/wav.rst                             |   8 ++
 docs/api/write.rst                           |   8 ++
 docs/{cli_template.rst => cli_template.rst_} |   0
 docs/conf.py                                 |  12 +++
 docs/index.rst                               |   1 +
 docs/requirements.txt                        |   2 +
 docs/usage.rst                               |  94 +++++++++++--------
 src/argparse.c                               |  24 -----
 src/argparse.h                               |   3 -
 src/mzf2wav.c                                |  34 ++++++-
 src/wav.c                                    |   4 +-
 18 files changed, 160 insertions(+), 77 deletions(-)
 delete mode 100644 doc/mzf2wavs1.gif
 create mode 100644 docs/Doxyfile
 create mode 100644 docs/api.rst
 create mode 100644 docs/api/methods.rst
 create mode 100644 docs/api/mzf.rst
 create mode 100644 docs/api/wav.rst
 create mode 100644 docs/api/write.rst
 rename docs/{cli_template.rst => cli_template.rst_} (100%)
 create mode 100644 docs/conf.py
 create mode 100644 docs/requirements.txt

diff --git a/.readthedocs.yaml b/.readthedocs.yaml
index 44c08a6..342e646 100644
--- a/.readthedocs.yaml
+++ b/.readthedocs.yaml
@@ -4,11 +4,14 @@ build:
   os: "ubuntu-22.04"
   tools:
     python: "3.9"
-  apt_packages:
-    - libisal-dev
   jobs:
     pre_build:
+      - doxygen docs/Doxyfile
       - make -C build/linux doc
 
+python:
+   install:
+   - requirements: docs/requirements.txt
+
 sphinx:
   configuration: docs/conf.py
diff --git a/build/linux/Makefile b/build/linux/Makefile
index ae6c292..0cd090e 100644
--- a/build/linux/Makefile
+++ b/build/linux/Makefile
@@ -15,7 +15,7 @@ $(EXEC): $(MAIN) $(OBJS)
 %.o: $(PTH)/%.c $(PTH)/%.h
 	$(CC) $(CFLAGS) -c $<
 
-../../docs/cli.rst: ../../docs/cli_template.rst $(EXEC)
+../../docs/cli.rst: ../../docs/cli_template.rst_ $(EXEC)
 	cp $< $@ && ./$(EXEC) -h >> $@
 
 clean:
diff --git a/doc/mzf2wavs1.gif b/doc/mzf2wavs1.gif
deleted file mode 100644
index c6c4ce1559959f76c21833798058f974685e96ea..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 10034
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

diff --git a/docs/Doxyfile b/docs/Doxyfile
new file mode 100644
index 0000000..cb86b3d
--- /dev/null
+++ b/docs/Doxyfile
@@ -0,0 +1,10 @@
+INPUT                  = src/
+OUTPUT_DIRECTORY       = docs/
+
+GENERATE_HTML          = NO
+GENERATE_LATEX         = NO
+GENERATE_XML           = YES
+
+INLINE_SIMPLE_STRUCTS  = YES
+
+FILE_PATTERNS          = *.c *.h
diff --git a/docs/api.rst b/docs/api.rst
new file mode 100644
index 0000000..0a5c933
--- /dev/null
+++ b/docs/api.rst
@@ -0,0 +1,12 @@
+API documentation
+=================
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Contents:
+   :glob:
+
+   api/wav
+   api/mzf
+   api/write
+   api/methods
diff --git a/docs/api/methods.rst b/docs/api/methods.rst
new file mode 100644
index 0000000..8917d3f
--- /dev/null
+++ b/docs/api/methods.rst
@@ -0,0 +1,8 @@
+Tape write methods
+==================
+
+.. code-block:: cpp
+
+    #include "methods.h"
+
+.. doxygenfile:: methods.h
diff --git a/docs/api/mzf.rst b/docs/api/mzf.rst
new file mode 100644
index 0000000..d81183e
--- /dev/null
+++ b/docs/api/mzf.rst
@@ -0,0 +1,8 @@
+MZF files
+=========
+
+.. code-block:: cpp
+
+    #include "mzf.h"
+
+.. doxygenfile:: mzf.h
diff --git a/docs/api/wav.rst b/docs/api/wav.rst
new file mode 100644
index 0000000..c6d750f
--- /dev/null
+++ b/docs/api/wav.rst
@@ -0,0 +1,8 @@
+WAV files
+=========
+
+.. code-block:: cpp
+
+    #include "wav.h"
+
+.. doxygenfile:: wav.h
diff --git a/docs/api/write.rst b/docs/api/write.rst
new file mode 100644
index 0000000..1ad4985
--- /dev/null
+++ b/docs/api/write.rst
@@ -0,0 +1,8 @@
+Tape write functions
+====================
+
+.. code-block:: cpp
+
+    #include "write.h"
+
+.. doxygenfile:: write.h
diff --git a/docs/cli_template.rst b/docs/cli_template.rst_
similarity index 100%
rename from docs/cli_template.rst
rename to docs/cli_template.rst_
diff --git a/docs/conf.py b/docs/conf.py
new file mode 100644
index 0000000..0582761
--- /dev/null
+++ b/docs/conf.py
@@ -0,0 +1,12 @@
+project = 'mzf2wav'
+author = 'Jeroen F.J. Laros'
+copyright = '2003-2023, {}'.format(author)
+
+extensions = ['breathe']
+breathe_projects = {'doxygen': 'xml'}
+breathe_default_project = 'doxygen'
+breathe_default_members = ('members',)
+
+master_doc = 'index'
+
+highlight_language = 'none'
diff --git a/docs/index.rst b/docs/index.rst
index 3819a4d..15acf1e 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -8,4 +8,5 @@
    install
    cli
    usage
+   api
    credits
diff --git a/docs/requirements.txt b/docs/requirements.txt
new file mode 100644
index 0000000..55928ee
--- /dev/null
+++ b/docs/requirements.txt
@@ -0,0 +1,2 @@
+breathe>=4.3.1
+docutils>=0.17.1
diff --git a/docs/usage.rst b/docs/usage.rst
index 04bf13b..89d49ce 100644
--- a/docs/usage.rst
+++ b/docs/usage.rst
@@ -9,70 +9,82 @@ named ``image.wav``:
     mzf2wav image.mzf image.wav
 
 
-Operation modes
----------------
+Modes of operation
+------------------
 
-Conventional sending mode
-~~~~~~~~~~~~~~~~~~~~~~~~~
+MZF2WAV supports different writing techniques that can shorten the loading
+time considerably. Please see the tape_ data processing page for more
+background information.
 
-This is the safest (and slowest) way to transfer an image, everything is done
-according to the Sharp MZ series conventions: A long gap is 22000 pulses, a
-short gap is 11000 pulses. The header and body are transferred twice to allow
-for errors.
-
-Fast sending mode
+Conventional mode
 ~~~~~~~~~~~~~~~~~
 
-This is the easiest way to transfer a file. In this mode the long gap (a tape
-marker) is 4000 pulses and the short gap is 5000 pulses. Both the header and
-the MZF image body are transferred once.
+In this mode, everything is done according to the Sharp MZ series
+conventions. A long gap is 22000 pulses, a short gap is 11000 pulses. The
+header and body are written twice to allow for errors. This mode can be
+selected using the ``-c`` command line option.
+
+Fast mode
+~~~~~~~~~
 
-Turbo sending mode
-~~~~~~~~~~~~~~~~~~
+In this mode, the long gap is 4000 pulses and the short gap is 5000 pulses.
+Both the header and the MZF image body are written once. This is the default
+mode.
 
-In this mode, the turbo loader is transferred using fast sending mode, this
-turbo loader enables the MZ to operate at higher transfer speeds. The MZF
-image is then sent using fast sending mode, but now at a higher speed.
+Turbo mode
+~~~~~~~~~~
 
-The speed at which the turbo loader is transferred is controlled with the
-``-i`` option, the speed at which the MZF image is sent is controlled with the
-``-t`` option.
+In this mode, a turbo loader is written using fast sending mode, which
+enables the MZ to operate at higher speeds. The MZF image is then sent using
+fast sending mode, but now at a higher speed. This mode can be selected using
+the ``-t`` command line option.
 
 
 Speeds
 ------
 
 Apart from increasing the pulse frequency, the waveforms themselves can be
-altered in order to increase speed. The "fast waveform" was found by minimising
-the high and the low states of the pulses independently.
+altered in order to increase speed.
+
+For conventional and fast mode, two predefined waveform configurations are
+available that can be selected using the ``-n`` command line option.
+
+For turbo mode, three predefined waveform configurations are available that
+can be selected using the ``-s`` command line option. This option can be
+combined with the ``-n`` option to also write the turbo loader at a higher
+speed. For example:
+
+::
 
-At this time, five speeds are implemented:
+    mzf2wav -t -n 1 -s 2 image.mzf image.wav
 
-- Speed 0: normal speed with normal waveforms.
-- Speed 1: normal speed with fast waveforms.
-- Speed 2: 2x speed with normal waveforms.
-- Speed 3: 3x speed with normal waveforms.
-- Speed 4: 3x speed with fast waveforms.
 
-These speeds can be set for all operation modes, although some combinations may
-not work. The most commonly used speeds are: speed 0 or 1 for initial speed
-mode and speed 2 or higher for turbo speed mode.
+Pulse customisation
+~~~~~~~~~~~~~~~~~~~
 
-If multiple images are transferred, using speed 3 or 4 with fast sending mode
-may be preferred.
+Next to the predefined waveform configurations, it is possible to make custom
+waveform configurations using the ``-N`` (conventional and fast mode) and
+``-S`` (turbo mode) options. For example:
 
-Corrections
-~~~~~~~~~~~
+::
+
+    mzf2wav -t -N 480,494,260,264 -S 248,248,113,140 image.mzf image.wav
 
-Because the waveforms used by speeds 1 and 4 may not always work, two
-correction factors for these speeds are implemented, controlled with the ``-1``
-and ``-2`` options.
+The pulse configuration consists of four comma separated values giving the
+length of the long pulse up, long pulse down, short pulse up and short pulse
+down times in microseconds.
 
 
 Polarity
 --------
 
-The polarity can be revered with the ``-p`` option.
+The polarity can be inverted using the ``-p`` option.
+
+
+Bit rate
+--------
+
+The bit rate is set using the ``-b`` option.
 
 
 Related software
@@ -83,6 +95,6 @@ Please check out MZF2WAVGUI_, a graphical user interface for this project
 directly connect to an MZ.
 
 
-.. _operation modes: https://github.com/jfjlaros/mzput#operation-modes
 .. _MZF2WAVGUI: https://github.com/rickyelqasem/MZF2WAVGUI
 .. _tutorial: https://www.youtube.com/watch?v=iwD3-5ENyE8
+.. _tape: https://web.archive.org/web/20201127232159/https://original.sharpmz.org/mz-700/tapeproc.htm
diff --git a/src/argparse.c b/src/argparse.c
index ac4da2b..86212c1 100644
--- a/src/argparse.c
+++ b/src/argparse.c
@@ -15,30 +15,6 @@ uint16_t const turboDefaults_[][4] = {
 Options const default_ = {
   NULL, NULL, fast, false, 44100, {0}, {0}, false, false, false};
 
-char const usage[] =
-  "usage: %s [-c] [-t] [-p] [-b BITRATE] [-n SPEED] [-s SPEED] "
-  "[-N FMT] [-S FMT] MZF WAV\n\n"
-  "positional arguments:\n"
-  "  MZF          input file in MZF format\n"
-  "  WAV          input file in WAV format\n\n"
-  "options:\n"
-  "  -h           display help information and exit\n"
-  "  -v           display version information and exit\n"
-  "  -c           conventional mode\n"
-  "  -t           turbo mode\n"
-  "  -p           invert polarity\n"
-  "  -b BITRATE   bit rate (dafault: 44100)\n"
-  "  -n SPEED     normal mode speed 0 or 1 (default: 0)\n"
-  "  -s SPEED     turbo mode speed 0, 1 or 2 (default: 0)\n"
-  "  -N FMT       custom waveform for normal mode\n"
-  "  -S FMT       custom waveform for turbo mode\n\n"
-  "FMT: long_up,long_down,short_up,short_down\n";
-
-char const version[] =
-  "MZF2WAV version 2.0.0\n"
-  "Copyright (c) 2003-2023 Jeroen F.J. Laros <jlaros@fixedpoint.nl>\n"
-  "Homepage: https://mzf2wav.readthedocs.io\n";
-
 
 size_t parseInt_(char const *const text, size_t const range) {
   size_t idx = strtoul(text, NULL, 10);
diff --git a/src/argparse.h b/src/argparse.h
index 5059637..41a9db0 100644
--- a/src/argparse.h
+++ b/src/argparse.h
@@ -17,9 +17,6 @@ typedef struct {
   bool version;        //!< Version.
 } Options;
 
-extern char const usage[];    // Usage string.
-extern char const version[];  // Version string.
-
 
 /*! Parse command line arguments.
  *
diff --git a/src/mzf2wav.c b/src/mzf2wav.c
index 1676c20..e76d290 100644
--- a/src/mzf2wav.c
+++ b/src/mzf2wav.c
@@ -3,6 +3,30 @@
 
 #include "argparse.h"
 
+char const usage_[] =
+  "usage: %s [-c] [-t] [-p] [-b BITRATE] [-n SPEED] [-s SPEED] "
+  "[-N FMT] [-S FMT] MZF WAV\n\n"
+  "positional arguments:\n"
+  "  MZF          input file in MZF format\n"
+  "  WAV          input file in WAV format\n\n"
+  "options:\n"
+  "  -h           display help information and exit\n"
+  "  -v           display version information and exit\n"
+  "  -c           conventional mode\n"
+  "  -t           turbo mode\n"
+  "  -p           invert polarity\n"
+  "  -b BITRATE   bit rate (dafault: 44100)\n"
+  "  -n SPEED     normal mode speed 0 or 1 (default: 0)\n"
+  "  -s SPEED     turbo mode speed 0, 1 or 2 (default: 0)\n"
+  "  -N FMT       custom waveform for normal mode\n"
+  "  -S FMT       custom waveform for turbo mode\n\n"
+  "FMT: long_up,long_down,short_up,short_down\n";
+
+char const version_[] =
+  "MZF2WAV version 2.0.0\n"
+  "Copyright (c) 2003-2023 Jeroen F.J. Laros <jlaros@fixedpoint.nl>\n"
+  "Homepage: https://mzf2wav.readthedocs.io\n";
+
 
 unsigned int fileSize_(FILE *handle) {
   fseek(handle, 0, SEEK_END);
@@ -79,14 +103,16 @@ bool mzf2wav(Options const *const options) {
 
 int main(int const argc, char *const *const argv) {
   Options options = argParse(argc, argv);
-  if (options.version) {
-    printf(version);
+  if (options.help) {
+    printf(usage_, argv[0]);
     return 0;
   }
-  if (options.help || options.error) {
-    printf(usage, argv[0]);
+  if (options.version) {
+    printf(version_);
+    return 0;
   }
   if (options.error || !mzf2wav(&options)) {
+    printf(usage_, argv[0]);
     return 1;
   }
 }
diff --git a/src/wav.c b/src/wav.c
index fa8ef29..2f9c43c 100644
--- a/src/wav.c
+++ b/src/wav.c
@@ -24,8 +24,8 @@ void writeInt_(FILE *const output, uint32_t const data) {
 
 
 void writeBit(FILE *const output, bool const bit, bool const invert) {
-  uint8_t const zero = 0x30;  // TODO: 0x00?
-  uint8_t const one = 0xd0;   // TODO: 0xff?
+  uint8_t const zero = 0x00;
+  uint8_t const one = 0xff;
 
   if (bit != invert) {
     fprintf(output, "%c", one);