Online documentation revisions

[Brian Inglis]

On 2023-09-27 02:42, Sam Edge wrote:
> On 26/09/2023 18:12, Sam Edge via Newlib wrote:
>  > On 26/09/2023 18:00, Brian Inglis wrote:
>  > > Had a similar issue wanting to see libc docs for Cygwin builds.
>  > >
>  > > Check out repo at that rev, configure into out of tree build and
> install dirs, then under e.g. build-3.0.0/newlib run to get into your
> e.g. install-3.0.0/usr/share/{info,man} dirs:
>  > >
>  > >     $ make info man && make install info man
>  > >
>  >
>  > Oh well. Guessed as much.
>  >
>  > Thanks for the TL;DR instructions. :-)
>  >
> 
> Well, that didn't work - see build.log attached. (Building on a Ubuntu
> 22.04 LTS based host by the way.)
> 
> Oh wait. Those are to build the manual pages. I'm after the one page
> HTML document for a non-cygwin bare-metal (e.g. arm-none-eabi-) build,
> sorry.
> 
> I've cloned from https://sourceware.org/git/newlib-cygwin.git and
> checked out newlib-3.0.0 (for example).
> 
> I have the GCC cross toolchain available if required but I don't want to
> build the binaries, just the all-on-one-page HTML documentation file.
> 
> What am I missing?

Sorry - doh! - there is a process as part of the build - requires makedoc to be 
built - and install- concatenated try:

	make doc info html && make install-html

We may be treading uncharted waters, and you may need to just pick up the bits 
of html generated, or do a full make to get html generated properly.
See newlib HOWTO!

-- 
Take care. Thanks, Brian Inglis              Calgary, Alberta, Canada

La perfection est atteinte                   Perfection is achieved
non pas lorsqu'il n'y a plus rien à ajouter  not when there is no more to add
mais lorsqu'il n'y a plus rien à retirer     but when there is no more to cut
                                 -- Antoine de Saint-Exupéry