Outdated ./guide.pdf?

[Paul Gilmartin]

The downloaded:
507 $ echo *.zip
Stellarium-26.1-qt6-macOS.zip

When unzipped contains:
508 $ find . -name \*.pdf
./Stellarium.app/Contents/Resources/guide/guide.pdf

But that guide.pdf says on its title page:
Version 25.3-1, December 6, 2025

Build phasing error?

--
Thanks,
gil

[Alexander V. Wolf]

сб, 25 апр. 2026 г. в 07:32, 'Paul Gilmartin' via Stellarium <stell...@googlegroups.com>:

Thanks for notification, I'll exclude this step from script of package building.

--

With best regards, Alexander

[Paul Gilmartin]

I'm disappointed.  It would be useful to have the current guide
installed with the app in a single operation.

And it appears that on windows, guide.pdf 26.1 was installed
automatically.

--
Thanks,
gil

[Alexander V. Wolf]

Hi!

вс, 17 мая 2026 г. в 01:55, 'Paul Gilmartin' via Stellarium <stell...@googlegroups.com>:

I'm disappointed.  It would be useful to have the current guide
installed with the app in a single operation.

Adding the PDF file of the User Guide into bundle was not very successful experiment on macOS platform. Similar problem you can see on all UNIX-like platforms - in modern days everyone use Internet to finding documentation.

 

And it appears that on windows, guide.pdf 26.1 was installed
automatically.

Yes, Windows allows incorporated the User Guide into installer and add simple link to the PDF file in Programs menu without troubles.

--

With best regards, Alexander

[Alexander V. Wolf]

In any way - if someone can share documents for correct incorporation the PDF files within macOS bundle with ability of simple use that PDF - pleas do it!

[Georg Zotti]

I don't see the problem. If a previous Mac bundle was found "guilty" of including an outdated Guide, just make sure to build the current PDF before packaging the next bundle. Some Makefile rules can probably be helpful. But I don't pack Mac bundles, so have no details. In any case, a current Guide is always available also as separate download. 

[Paul Gilmartin]

On 5/17/26 03:09, Georg Zotti wrote:
> I don't see the problem. If a previous Mac bundle was found "guilty" of including an outdated Guide, just make sure to build the current PDF before packaging the next bundle. Some Makefile rules can probably be helpful. But I don't pack Mac bundles, so have no details. In any case, a current Guide is always available also as separate download.

>     ...
Alexander has a valid concern of "ability of simple use".  If it is desirable for
performance and economy of bandwidth to keep guide.pdf locally, then
the Help.>About window should contain a hyperlink:
<file:///Applications/Stellarium.app/Contents/Resources/guide/guide.pdf>
That's Mac-specific.  It would be different for each platform.

If it's preferred to leave guide.pdf on the web site, that
hyperlink in  the Help.>About window should be:
    <https://stellarium.org/files/guide.pdf>

For users who desire a local guide.pdf in a Documents folder, many
browsers and other tools support downloading given a URL.

My long-standing concern with "ability of simple use". has
been the Command Line Interface for Mac    OS.  Guide.pdf
has only hyperlinks to the sparse:
    5.1.2 macOS
    installation directory This is found inside the application
    bundle, Stellarium.app. See The Anatomy of macOS
    App Bundles4 or Bundle Programming Guide5 for more
    information.

The instructions should be complete.

> alex....@gmail.com schrieb am Sonntag, 17. Mai 2026 um 11:02:45 UTC+2:
>
> In any way - if someone can share documents for correct incorporation the PDF files within macOS bundle with ability of simple use that PDF - pleas do it!
>

--

Thanks,
gil