[Bug other/106899] New: Snapshots do not contain pre-generated man pages & info pages

[Bug other/106899] New: Snapshots do not contain pre-generated man pages & info pages

[sam at gentoo dot org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=106899

            Bug ID: 106899
           Summary: Snapshots do not contain pre-generated man pages &
                    info pages
           Product: gcc
           Version: unknown
            Status: UNCONFIRMED
          Severity: normal
          Priority: P3
         Component: other
          Assignee: unassigned at gcc dot gnu.org
          Reporter: sam at gentoo dot org
  Target Milestone: ---

Would it be possible for the weekly snapshots to include pre-generated .info
pages (and man pages)?

Full releases do:
```
# find . | grep -i "\.info$"
./gcc-11.3.0/libquadmath/libquadmath.info
./gcc-11.3.0/libgomp/libgomp.info
./gcc-11.3.0/libitm/libitm.info
./gcc-11.3.0/gcc/fortran/gfortran.info
./gcc-11.3.0/gcc/doc/gccinstall.info
./gcc-11.3.0/gcc/doc/gccint.info
./gcc-11.3.0/gcc/doc/cpp.info
./gcc-11.3.0/gcc/doc/cppinternals.info
./gcc-11.3.0/gcc/doc/gcc.info
```

But snapshots don't:
```
/var/tmp/portage/sys-devel/gcc-11.3.1_p20220909/work # find . | grep -i
"\.info$"
/var/tmp/portage/sys-devel/gcc-11.3.1_p20220909/work #
```

[Bug other/106899] Snapshots do not contain pre-generated man pages & info pages

[pinskia at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=106899

--- Comment #1 from Andrew Pinski <pinskia at gcc dot gnu.org> ---
Right this is done on purpose as snapshots are just snapshots of the sources
directly from the git.

[Bug other/106899] Snapshots do not contain pre-generated man pages & info pages

[pinskia at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=106899

--- Comment #2 from Andrew Pinski <pinskia at gcc dot gnu.org> ---
"Public releases and weekly snapshots of the development sources are also
available via HTTPS."

"Necessary to build GCC documentation during development because the generated
output files are not included in the repository. They are included in
releases."

From https://gcc.gnu.org/install/prerequisites.html


Also I suspect building the snapshot with the generated files will no longer be
considered a snapshot but a snap release instead. Since it is not exactly what
is in the git repo anymore.

[Bug other/106899] Snapshots do not contain pre-generated man pages & info pages

[sam at gentoo dot org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=106899

--- Comment #3 from Sam James <sam at gentoo dot org> ---
Yeah, I understand it's not an error per se, just wondering if it could be
considered to add them.

It looks like they're generated from the same script used for releases:
maintainer-scripts/gcc_release (as it handles announcing them too, and diffs,
etc).

I didn't realise it didn't do a test build at all (figured if it did, could
just shove in --enable-generated-files-in-srcdir).

At least the machinery is largely there, but it'd involve actually doing at
least a minimal build before generating the snapshots.

[Bug other/106899] Snapshots do not contain pre-generated man pages & info pages

[pinskia at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=106899

--- Comment #4 from Andrew Pinski <pinskia at gcc dot gnu.org> ---
So the issue is when we do a release, do a full build of GCC.
Doing a snapshot does NOT do the full build because of resource constraints.
We have at least any one time, 4 snapshots happening during the week.
the machine which hosts gcc is doing the snapshots so taking resources away
from other projects too.

We could do this yes but I doubt we want to do for a few reasons.
1) No longer a true snapshot of the source.
2) resource constraints on building the snapshot
3) building the generated files while using snapshot/git is not a bad thing

[Bug other/106899] Snapshots do not contain pre-generated man pages & info pages

[rguenth at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=106899

--- Comment #5 from Richard Biener <rguenth at gcc dot gnu.org> ---
The resource issue is probably a non-issue these days

[Bug other/106899] Snapshots do not contain pre-generated man pages & info pages

[mark at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=106899

Mark Wielaard <mark at gcc dot gnu.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |mark at gcc dot gnu.org

--- Comment #6 from Mark Wielaard <mark at gcc dot gnu.org> ---
(In reply to Richard Biener from comment #5)
> The resource issue is probably a non-issue these days

Yes, we have more hardware these these. Even a separate machine just to create
snapshots. Thanks to OSUOSL we now have https://snapshots.sourceware.org/ to
publish static artifacts from current git repos created in isolated containers.
It can be used as alternative to cron jobs on the main machine to generate
snapshots and documentation. The container files and build steps are defined
through the builder project.

We could do both. Have the current snapshots once a week. And have a full
"release snapshot" through snapshorts.sourceware.org whenever the sources
change (every hour) that regenerates all generated files (so we also know
whenever manual creation is broken).

[Bug other/106899] Snapshots maybe should contain pre-generated man pages & info pages

[pinskia at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=106899

Andrew Pinski <pinskia at gcc dot gnu.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
            Summary|Snapshots do not contain    |Snapshots maybe should
                   |pre-generated man pages &   |contain pre-generated man
                   |info pages                  |pages & info pages
           Severity|normal                      |enhancement