bug#25293: More descriptive page titles in documentation?

bug#25293: More descriptive page titles in documentation?

[saffronsnail]

[-- Attachment #1: Type: text/plain, Size: 881 bytes --]

Hello, 
Frequently when I am working on guile code I have a few tabs open with
particular sections of interest open. The titles of the pages all
start with "Guile Reference Manual", which is not useful when
switching between tabs. Would it be possible to retitle the pages so
that the name of the section is first? For example, right now I have
section 6.19.3 open and the title is "Guile Reference Manual: Creating
Guile Modules". I also have section 6.20.6 open and the title is
"Guile Reference Manual: Dynamic FFI". The names displayed in the tabs
are both "Guile Referenc Man...". Rearranging the titles to be
"Creating Guile Modules: Guile Reference Manual" and "Dynamic FFI:
Guile Reference Manual" would make it easier to go directly to the tab
with the information I need, rather than cycling through 4-5 different
tabs to find the one I'm looking for.
Thanks,saffronsnail

[-- Attachment #2: Type: text/html, Size: 1178 bytes --]

bug#25293: More descriptive page titles in documentation?

[Andy Wingo]

On Thu 29 Dec 2016 19:43, saffronsnail@hushmail.com writes:

> Frequently when I am working on guile code I have a few tabs open with
> particular sections of interest open. The titles of the pages all
> start with "Guile Reference Manual", which is not useful when
> switching between tabs. Would it be possible to retitle the pages so
> that the name of the section is first? For example, right now I have
> section 6.19.3 open and the title is "Guile Reference Manual: Creating
> Guile Modules". I also have section 6.20.6 open and the title is
> "Guile Reference Manual: Dynamic FFI". The names displayed in the tabs
> are both "Guile Referenc Man...". Rearranging the titles to be
> "Creating Guile Modules: Guile Reference Manual" and "Dynamic FFI:
> Guile Reference Manual" would make it easier to go directly to the tab
> with the information I need, rather than cycling through 4-5 different
> tabs to find the one I'm looking for.

Not a bad idea!  Probably we should take this one up with the makeinfo
people.

Andy

bug#25293: More descriptive page titles in documentation?

[Andy Wingo]

Hello Texinfo peoples,

We have a suggestion that Guile's HTML manual, e.g.

  https://www.gnu.org/software/guile/docs/master/guile.html/Procedures-as-Values.html#Procedures-as-Values

should have the <title> be defined like:

  Procedures as Values: Guile Reference Manual

instead of

  Guile Reference Manual: Procedures as Values

Any thoughts on if this is possible and if so, how to get it working?

Cheers,

Andy

On Mon 09 Jan 2017 22:56, Andy Wingo <wingo@pobox.com> writes:

> On Thu 29 Dec 2016 19:43, saffronsnail@hushmail.com writes:
>
>> Frequently when I am working on guile code I have a few tabs open with
>> particular sections of interest open. The titles of the pages all
>> start with "Guile Reference Manual", which is not useful when
>> switching between tabs. Would it be possible to retitle the pages so
>> that the name of the section is first? For example, right now I have
>> section 6.19.3 open and the title is "Guile Reference Manual: Creating
>> Guile Modules". I also have section 6.20.6 open and the title is
>> "Guile Reference Manual: Dynamic FFI". The names displayed in the tabs
>> are both "Guile Referenc Man...". Rearranging the titles to be
>> "Creating Guile Modules: Guile Reference Manual" and "Dynamic FFI:
>> Guile Reference Manual" would make it easier to go directly to the tab
>> with the information I need, rather than cycling through 4-5 different
>> tabs to find the one I'm looking for.
>
> Not a bad idea!  Probably we should take this one up with the makeinfo
> people.
>
> Andy

bug#25293: More descriptive page titles in documentation?

[Gavin Smith]

On 1 March 2017 at 14:49, Andy Wingo <wingo@pobox.com> wrote:
> Hello Texinfo peoples,
>
> We have a suggestion that Guile's HTML manual, e.g.
>
>   https://www.gnu.org/software/guile/docs/master/guile.html/Procedures-as-Values.html#Procedures-as-Values
>
> should have the <title> be defined like:
>
>   Procedures as Values: Guile Reference Manual
>
> instead of
>
>   Guile Reference Manual: Procedures as Values
>
> Any thoughts on if this is possible and if so, how to get it working?

I don't know if you can do it easily with any released version of
Texinfo, but I changed the order on the suggestion of Bryan Ferris on
2017-01-21 in the development code. I believe it is now "Procedures as
Values (Guile Reference Manual)" and will be output this way in the
next release, if nothing changes before then.

bug#25293: More descriptive page titles in documentation?

[Andy Wingo]

On Wed 01 Mar 2017 19:40, Gavin Smith <gavinsmith0123@gmail.com> writes:

> On 1 March 2017 at 14:49, Andy Wingo <wingo@pobox.com> wrote:
>> Hello Texinfo peoples,
>>
>> We have a suggestion that Guile's HTML manual, e.g.
>>
>>   https://www.gnu.org/software/guile/docs/master/guile.html/Procedures-as-Values.html#Procedures-as-Values
>>
>> should have the <title> be defined like:
>>
>>   Procedures as Values: Guile Reference Manual
>>
>> instead of
>>
>>   Guile Reference Manual: Procedures as Values
>>
>> Any thoughts on if this is possible and if so, how to get it working?
>
> I don't know if you can do it easily with any released version of
> Texinfo, but I changed the order on the suggestion of Bryan Ferris on
> 2017-01-21 in the development code. I believe it is now "Procedures as
> Values (Guile Reference Manual)" and will be output this way in the
> next release, if nothing changes before then.

That's great to hear :-)  We'll pick up this change when the next
release comes out.

Happy hacking,

Andy