Version 0.3.0

Released on 2025-05-20.

macOS

# download from assets:
#   today-v0.3.0-macos
#   today-v0.3.0-man.1

# run program
cd ~/Downloads                                   # or wherever you saved it
mv -v ./today-v0.3.0-macos ./today               # rename
chmod u+x ./today                                # make executable
xattr -dv com.apple.quarantine ./today           # remove security block
./today --version                                # check version
./today                                          # run

# install program
sudo cp -v ./today /usr/local/bin/               # or wherever you like
today                                            # verify

# view man page
cd ~/Downloads                                   # or wherever you saved it
mv -v ./today-v0.3.0-man.1 ./today.1             # rename
man ./today.1                                    # preview

# install man page
sudo cp -v ./today.1 /usr/local/share/man/man1/  # or wherever you like
man today                                        # verify

Linux

# download from assets:
#   today-v0.3.0-linux
#   today-v0.3.0-man.1

# run program
cd ~/Downloads                                   # or wherever you saved it
mv -v ./today-v0.3.0-linux ./today               # rename
chmod u+x ./today                                # make executable
./today --version                                # check version
./today                                          # run

# install program
sudo cp -v ./today /usr/local/bin/               # or wherever you like
today                                            # verify

# view man page
cd ~/Downloads                                   # or wherever you saved it
mv -v ./today-v0.3.0-man.1 ./today.1             # rename
man ./today.1                                    # preview

# install man page
sudo cp -v ./today.1 /usr/local/share/man/man1/  # or wherever you like
man today                                        # verify

Changelog - 0.3.0 - 2025-05-20

Managing a single source of truth between program and man page.

Added

• Source code:
  • VERSION macro
  • --help and --version options
• Build system:
  • make man
  • make dist
  • make install/uninstall with man page
  • make show-version
  • make run with ARGS for command-line arguments
  • Banners to show information about current stages
• Project website:
  • User Guide section
  • Technical Details section
    • Single Source of Truth subsection
    • Makefile in Detail subsection
    • Ready for Deployment subsection
  • Enable features for code copy, footer, navigation
  • Enable extensions for code highlight
• Manual page:
  • Man page with conversion from help2man
• Assets:
  • Mermaid diagrams for project website and code reference
  • Screenshots of man page and help info
• Project information:
  • Changelog.md:
    • Version 0.3.0
  • VERSION as the definitive source for software version

Changed

• Build system:
  • Do not use BINSTAMP; just use order-only prerequisite on BIN_DIR