Online documentation: Regeneration?

classic Classic list List threaded Threaded
4 messages Options
Reply | Threaded
Open this post in threaded view
|

Online documentation: Regeneration?

Georg-Johann Lay-2
Hi,

1.5 weeks ago, a patch was applied to master which changed parts of the
user documentation, namely gas/doc/c-avr.texi cf.
https://sourceware.org/git/gitweb.cgi?p=binutils-gdb.git;h=32f76c677333510350f21a40db062a8d17995c53

There should be a 4th node "Pseudo Instructions" now in

http://sourceware.org/binutils/docs/as/AVR_002dDependent.html

I'd expect that the online documentation is re-generated at least once
per week, so that the web documentation should have caught up with the
documentation's sources?

Is there a special trigger needed to start re-generation of online docs
and flush the contents?

Thanks,

Johann
Reply | Threaded
Open this post in threaded view
|

Re: Online documentation: Regeneration?

Tristan Gingold-2
On 09/07/2017 13:47, Georg-Johann Lay wrote:

> Hi,
>
> 1.5 weeks ago, a patch was applied to master which changed parts of the
> user documentation, namely gas/doc/c-avr.texi cf.
> https://sourceware.org/git/gitweb.cgi?p=binutils-gdb.git;h=32f76c677333510350f21a40db062a8d17995c53 
>
>
> There should be a 4th node "Pseudo Instructions" now in
>
> http://sourceware.org/binutils/docs/as/AVR_002dDependent.html
>
> I'd expect that the online documentation is re-generated at least once
> per week, so that the web documentation should have caught up with the
> documentation's sources?
>
> Is there a special trigger needed to start re-generation of online docs
> and flush the contents?

These docs are updated during the release.  So that's the doc of
binutils 2.28.

Tristan.
Reply | Threaded
Open this post in threaded view
|

Re: Online documentation: Regeneration?

Georg-Johann Lay-2
On 11.07.2017 09:25, Tristan Gingold wrote:

> On 09/07/2017 13:47, Georg-Johann Lay wrote:
>> Hi,
>>
>> 1.5 weeks ago, a patch was applied to master which changed parts of
>> the user documentation, namely gas/doc/c-avr.texi cf.
>> https://sourceware.org/git/gitweb.cgi?p=binutils-gdb.git;h=32f76c677333510350f21a40db062a8d17995c53 
>>
>>
>> There should be a 4th node "Pseudo Instructions" now in
>>
>> http://sourceware.org/binutils/docs/as/AVR_002dDependent.html
>>
>> I'd expect that the online documentation is re-generated at least once
>> per week, so that the web documentation should have caught up with the
>> documentation's sources?
>>
>> Is there a special trigger needed to start re-generation of online
>> docs and flush the contents?
>
> These docs are updated during the release.  So that's the doc of
> binutils 2.28.
>
> Tristan.


hmmm 2.28 didn't update either:

https://sourceware.org/binutils/docs-2.28/as/AVR_002dDependent.html

So the "docs" folder is built from 2.28 release and the docs-2.28 is
built from the 2.27 release?  Confusing...

Johann




Reply | Threaded
Open this post in threaded view
|

Re: Online documentation: Regeneration?

Tristan Gingold-2
On 11/07/2017 11:41, Georg-Johann Lay wrote:

> On 11.07.2017 09:25, Tristan Gingold wrote:
>> On 09/07/2017 13:47, Georg-Johann Lay wrote:
>>> Hi,
>>>
>>> 1.5 weeks ago, a patch was applied to master which changed parts of
>>> the user documentation, namely gas/doc/c-avr.texi cf.
>>> https://sourceware.org/git/gitweb.cgi?p=binutils-gdb.git;h=32f76c677333510350f21a40db062a8d17995c53 
>>>
>>>
>>> There should be a 4th node "Pseudo Instructions" now in
>>>
>>> http://sourceware.org/binutils/docs/as/AVR_002dDependent.html
>>>
>>> I'd expect that the online documentation is re-generated at least
>>> once per week, so that the web documentation should have caught up
>>> with the documentation's sources?
>>>
>>> Is there a special trigger needed to start re-generation of online
>>> docs and flush the contents?
>>
>> These docs are updated during the release.  So that's the doc of
>> binutils 2.28.
>>
>> Tristan.
>
>
> hmmm 2.28 didn't update either:
>
> https://sourceware.org/binutils/docs-2.28/as/AVR_002dDependent.html
>
> So the "docs" folder is built from 2.28 release and the docs-2.28 is
> built from the 2.27 release?  Confusing...

IIRC, docs is a symlink to docs-2.28