Logo10.3.177.165 
  News  Recent  Stats  Forums  Discord  GitHub  Contact
  Menu
 Username

 Password


   Register here

 Main menu
   BBCode test
 
 Content
   List Content
 
 Projects
   All projects
  View project
[All projects][View on GitHub][Git Log]
Name:ExtraVersion
Short description:ExtraVersion: $EXTVER: convention for storing a program's original (non-Amiga) version string, and an AmigaOS 4 command that reads it; by Marko K. Seppänen
Full description:

ExtraVersion

ExtraVersion: a $EXTVER: convention for storing a program's original (non-Amiga) version string, and an AmigaOS 4 command that reads it. By Marko K. Seppänen.

Ported software often has a version string that doesn't fit the Amiga version string format. ExtraVersion adds a second string next to the normal $VER: string (never instead of it) for the original version.

Version 1.0 beta (2016-02-26).

The extra version string

From the readme: put this string of characters in the file:

"\0$EXTVER: Program_Name ExtraVersionString (dd.mm.yyyy) Some comment.\0"
  • Program_Name: name of your program
  • ExtraVersionString: any non-Amiga version string (use _ for spaces)
  • dd.mm.yyyy: day, month and four-digit year
  • comment: optional, just for readability

The command

EXTRAVERSION [<library|script|file>] [FULL|VSTRING|HELP]
Template: NAME, FULL/S, HELP/S, VSTRING/S
  • no option: prints the name and extra version string
  • FULL: name, extra version, date and comment on one line
  • VSTRING: the complete extra version string, including $EXTVER:

It works on both text files and executables. The full documentation is docs/ExtraVersion.doc.

Building

src/Makefile builds with GCC (newlib) on AmigaOS 4: make builds ExtraVersion, make test a test build, make release and make lha the release in release/. src/tests/good and src/tests/bad hold more than 60 test files with correct and broken extra version strings.

Contents

  • src/: extraversion.c, the makefile, a built ExtraVersion and the test files.
  • docs/: the readme, the AutoDoc-style ExtraVersion.doc, the developer notes and to-do list (DevDoc.txt) and the OS4Depot upload text.
  • release/: the 1.0 beta release, also as ExtraVersion.lha.

Original project description

The OpenAmiga.org project page described the goal like this:

Since a lot of software are being ported from other platforms that use version strings that are not compatible with Amiga version strings, a need to be able to store both an amiga version string and the version string of the original software has arisen.

This project is about inventing a method for storing such an extra version string inside software binaries, as well as about creating a tool to extract the data.

Once completed the solution will be presented to Hyperion as a proposal for the official AmigaOS way of storing this type of information.

Note that the new version string is Not a replacement for the Amiga version string. It is only a complement and an amiga version string must always be included in the software independent of the original software version.

History

The project was created on OpenAmiga.org in 2008. Marko K. Seppänen wrote ExtraVersion in 2014 (0.4, beta 1) and rewrote most of it for 1.0 beta in 2016, in the OpenAmiga.org Subversion repository. Moved to GitHub in November 2026, with its full commit history.

Open Amiga project website, Created in 2008 by Björn Hagström