Amiga version strings - guide

	Bottom Previous Topic Next Topic
Register To Post

orgin

Posted on: 2008/9/5 14:02 #1

Supreme Council

I wrote a guide on OpenAmiga.org on how to use Amiga Version strings.

You can find it here

Rigo helped me with a lot of background information, so major kudos to him.

Vacca foeda. Sum, ergo edo

Mr Bobo Cornwater

thomas

Re: Amiga version strings - guide

Posted on: 2008/9/5 14:32 #2

Not too shy to talk

@orgin

The date format is not correct. It's dd.mm.yy or (since OS 3.9) dd.mm.yyyy.

i.e. 01.02.03 gives 01-Feb-2003.

Bye,
Thomas

Rigo

Re: Amiga version strings - guide

Posted on: 2008/9/5 15:04 #3

Supreme Council

@thomas

Fixed, thanks. I read that 5 or 6 times and didn't spot that.

Simon

Gazelle

Re: Amiga version strings - guide

Posted on: 2008/9/5 15:15 #4

Just popping in

@Rigo

I also think that the leading zero for day or month is not required.

/edit:

And a leading zero infront of the revision does mean a subrevision eg like the AmigaOS:
2.0 -> 2.04 -> 2.05 ->2.1

Maybe this was dropped again after release 2.1

TSK

Re: Amiga version strings - guide

Posted on: 2008/9/5 19:00 #5

Just can't stay away

Thanks making this guide !

Rock lobster bit me - so I'm here forever
X1000 + AmigaOS 4.1 FE
"Anyone can build a fast CPU. The trick is to build a fast system." - Seymour Cray

Rigo

Re: Amiga version strings - guide

Posted on: 2008/9/5 19:15 #6

Supreme Council

@Gazelle

Quote:

Gazelle wrote:
I also think that the leading zero for day or month is not required.

While bumprev doesn't supply them, and the internal locale routines don't specifically require them either, it is workable to leave them out, although the specified standard stipulates that the day and month are two digit.
If it really bothers anyone, send the code to me and I'll add the two zeros to save them the bother :P

Quote:

And a leading zero infront of the revision does mean a subrevision eg like the AmigaOS:
2.0 -> 2.04 -> 2.05 ->2.1

Maybe this was dropped again after release 2.1

I very much doubt that this was part of the version string standard (my reference material is not available to check), and is certainly not applicable by todays standards. The above numbering system implies a decimal number, which would follow the numerical sequence. Version strings do not follow the decimal notation for their version and revision.

Simon

Gazelle

Re: Amiga version strings - guide

Posted on: 2008/9/5 20:49 #7

Just popping in

@Rigo & orgin

I forgot to thank you for making the documentation, so thanks.

I'm just nitpicking to get it even better :)

Quote:

from ADCD_2.1:NDK/NDK_3.1/Docs/tutorials/V38_V39_OS_Changes:

[...] Following the revision number comes a space, and then the date. The date is specified in numeric form only, with no leading zeros on any of the components. [...]

And you're right:

Quote:

Leading Zeros. Leading zeros are not supported as part of the version and revision numbers. So "2.04" is not a valid version/revision pair as far as the version command is concerned.

Maybe it's also worth mentioning:

Quote:

<name> can NOT contain any spaces. You can use underscores to achieve a similar effect.

/edit: ?hem, translate2AmigaPath() ;)

Chris

Re: Amiga version strings - guide

Posted on: 2008/9/6 0:06 #8

Amigans Defender

@Rigo

Quote:

Quote:

And a leading zero infront of the revision does mean a subrevision eg like the AmigaOS:
2.0 -> 2.04 -> 2.05 ->2.1

I very much doubt that this was part of the version string standard (my reference material is not available to check)

You're absolutely correct, Commodore had a dual version numbering policy, where OS releases would be numbered as version . major-revision minor-revision. Internal version numbers would always be the incrementing version . revision format.

In OS release terms, 2.1 comes after 2.04. In internal version numbering, 2.04 (=2.4) comes after 2.1.

Of course this is still in place with OS4.

I tried the same dual-numbering system with Wet but nobody understood it!

Chris

LiveForIt

Re: Amiga version strings - guide

Posted on: 2008/9/6 0:12 #9

Home away from home

@Chris

So 2.04 in AmigaOS is 2.0.4 in Linux.

Edited by LiveForIt on 2008/9/6 8:01:46

(NutsAboutAmiga)

Basilisk II for AmigaOS4
AmigaInputAnywhere
Excalibur
and other tools and apps.

Rigo

Re: Amiga version strings - guide

Posted on: 2008/9/6 2:31 #10

Supreme Council

@Chris

I'm not really surprised. Seems people are having enough trouble understanding this simpler form of versioning, which is why this document came about.

If we all stick to the specified standards, we'll be OK :)

Simon

LiveForIt

Re: Amiga version strings - guide

Posted on: 2008/9/6 8:13 #11

Home away from home

@Rigo

Quote:

Software originally targeting other OS'es, such as Linux, often use a version format that is alien to the Amiga version format. Don't use the alien format inside Amiga version strings. Instead create a new version string that represents the version.revision of your port.

I disagree whit this, how do you know witch version you have ported from if you do not use the Linux version number?

and how do you write version 2.20.4 in Amiga format?

This makes me think that AmigaOS does not have flexibility we need for version numbers.

(NutsAboutAmiga)

Basilisk II for AmigaOS4
AmigaInputAnywhere
Excalibur
and other tools and apps.

orgin

Re: Amiga version strings - guide

Posted on: 2008/9/6 11:03 #12

Supreme Council

@LiveForIt

You can't do that since then all version tools will go bananas and suddenly we can't use stuff like version checks on libraries etc.

Amiga version strings should stay Amiga version strings and nothing else. Alien/Linux version strings would have to be handled in some other way. Just embed another cookie* in your software or use the amiga version string comment field.

Messing up the amiga versioning system is not the way to go.

* such as "\0$EXTVER 1.1.2 (5.9.2008) a comment\0"

Vacca foeda. Sum, ergo edo

Mr Bobo Cornwater

Rigo

Re: Amiga version strings - guide

Posted on: 2008/9/6 22:59 #13

Supreme Council

@orgin

Exactly right. Whether the Amiga version string standard does or doesn't have the flexibility to allow Linux version strings is besides the point.

Standards are standards (even if AmiUpdate does support the 1.1.1 version strings :)

Simon

Register To Post
	Top Previous Topic Next Topic

Currently Active Users Viewing This Thread: 1 ( 0 members and 1 Anonymous Users )