link to gnome developer example for autotools?

link to gnome developer example for autotools?

[Robert P. J. Day]

  this section:

file:///home/rpjday/oe/dist/layers/yocto-docs/documentation/_build/html/sdk-manual/working-projects.html

notes:

"For more information on the GNU Autotools workflow, see the same
example on the GNOME Developer site."

  not sure what "same example" this is referring to, but can someone
clarify what link can be added here corresponding to the alleged
example?

rday

Re: [docs] link to gnome developer example for autotools?

[Michael Opdenacker]

Hi Robert,

On 5/1/21 10:02 PM, Robert P. J. Day wrote:
>   this section:
>
> file:///home/rpjday/oe/dist/layers/yocto-docs/documentation/_build/html/sdk-manual/working-projects.html


You meant https://docs.yoctoproject.org/sdk-manual/working-projects.html
(you referred to a local link).

>
> notes:
>
> "For more information on the GNU Autotools workflow, see the same
> example on the GNOME Developer site."
>
>   not sure what "same example" this is referring to, but can someone
> clarify what link can be added here corresponding to the alleged
> example?


I guess the reference is
https://developer.gnome.org/anjuta-build-tutorial/stable/create-autotools.html.en

Indeed, we should provide readers with a direct link instead of
expecting them to find such a page through a search engine.

Actually, this example just adds a little more than what we already
explain. Instead shouldn't we provide links to the original
documentation for the autotools, such as
https://www.gnu.org/software/automake/#documentation for automake and
https://www.gnu.org/software/autoconf/ for autoconf? If we do that, it's
what we already get from the link to
https://en.wikipedia.org/wiki/GNU_Build_System already provided at the
beginning of the section.

If you agree, I vote to remove the note entirely.

Cheers,

Michael.

-- 
Michael Opdenacker, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com

Re: [docs] link to gnome developer example for autotools?

[Quentin Schulz]

Hi all,

On Wed, May 05, 2021 at 06:03:43PM +0200, Michael Opdenacker wrote:
> Hi Robert,
> 
> On 5/1/21 10:02 PM, Robert P. J. Day wrote:
> >   this section:
> >
> > file:///home/rpjday/oe/dist/layers/yocto-docs/documentation/_build/html/sdk-manual/working-projects.html
> 
> 
> You meant https://docs.yoctoproject.org/sdk-manual/working-projects.html
> (you referred to a local link).
> 
> >
> > notes:
> >
> > "For more information on the GNU Autotools workflow, see the same
> > example on the GNOME Developer site."
> >
> >   not sure what "same example" this is referring to, but can someone
> > clarify what link can be added here corresponding to the alleged
> > example?
> 
> 
> I guess the reference is
> https://developer.gnome.org/anjuta-build-tutorial/stable/create-autotools.html.en
> 

Yes. It was lost during the migration.

See:
https://www.yoctoproject.org/docs/latest/mega-manual/mega-manual.html#autotools-based-projects

When there are things which seem a bit odd, I usually check with the
documentation at that link (which I told Robert to not look at anymore :p)
which is the latest doc before the sphinx migration.

> Indeed, we should provide readers with a direct link instead of
> expecting them to find such a page through a search engine.
> 
> Actually, this example just adds a little more than what we already
> explain. Instead shouldn't we provide links to the original
> documentation for the autotools, such as
> https://www.gnu.org/software/automake/#documentation for automake and
> https://www.gnu.org/software/autoconf/ for autoconf? If we do that, it's
> what we already get from the link to
> https://en.wikipedia.org/wiki/GNU_Build_System already provided at the
> beginning of the section.
> 
> If you agree, I vote to remove the note entirely.
> 

I'd check first in the git history what the original intent was before
removing it.

Cheers,
Quentin

Re: [docs] link to gnome developer example for autotools?

[Robert P. J. Day]

On Wed, 5 May 2021, Michael Opdenacker wrote:

> Hi Robert,
>
> On 5/1/21 10:02 PM, Robert P. J. Day wrote:
> >   this section:
> >
> > file:///home/rpjday/oe/dist/layers/yocto-docs/documentation/_build/html/sdk-manual/working-projects.html
>
>
> You meant https://docs.yoctoproject.org/sdk-manual/working-projects.html
> (you referred to a local link).

  quite so, my fault, i had two tabs open, one to the official YP docs
page, the other to my local sphinx-based build of the latest content,
just mixed up the two.

rday