Ask Your Question
0

User Guide Version Numbers

asked 2019-02-18 00:05:00 +0000

SysAdmin101 gravatar image

updated 2019-02-18 00:50:12 +0000

OK... this has been bugging me for ages, why is it that the version of the User Guide is always ahead of the actual [software] version of Wireshark?

For example, the current RC is 3.0.0 however the User Guide is 3.1.0.

I can just about understand a User Guide being a version or two behind the software version, but ahead...???

Thanks.

edit retag flag offensive close merge delete

1 Answer

Sort by ยป oldest newest most voted
0

answered 2019-02-18 01:27:49 +0000

Guy Harris gravatar image

It's because the User Guide - and Developer Guide - on the Web site are built from the tip of the master branch of the Wireshark Git repository, and the 3.0 release is now on a separate branch, so the master branch is for the next release after 3.0, which will be called 3.1 while it's a development release and 3.2 when it''s eventually released.

Perhaps we should build separate versions of the guide for all the releases we're currently offering, and either not offer one built from the master branch or offer it as "future release" or something such as that; you might want to file a bug report on the Wireshark Bugzilla about this.

edit flag offensive delete link more

Comments

OTOH, development of the User Guide usually trails the software, sometimes considerably. So having a newer User Guide can still be relevant for the versions before the stated one. In short, we're programmers, not document writers, and that shows.

Jaap gravatar imageJaap ( 2019-02-18 18:33:33 +0000 )edit

OTOH, development of the User Guide usually trails the software, sometimes considerably. So having a newer User Guide can still be relevant for the versions before the stated one.

Time to go out to the orchard and pick some cherries....

Guy Harris gravatar imageGuy Harris ( 2019-02-18 18:43:44 +0000 )edit

Your Answer

Please start posting anonymously - your entry will be published after you log in or create a new account.

Add Answer

Question Tools

1 follower

Stats

Asked: 2019-02-18 00:05:00 +0000

Seen: 580 times

Last updated: Feb 18 '19