unofficial mirror of bug-guile@gnu.org 
 help / color / mirror / Atom feed
* bug#25293: More descriptive page titles in documentation?
@ 2016-12-29 18:43 saffronsnail
  2017-01-09 21:56 ` Andy Wingo
  0 siblings, 1 reply; 5+ messages in thread
From: saffronsnail @ 2016-12-29 18:43 UTC (permalink / raw)
  To: 25293

[-- 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 --]

^ permalink raw reply	[flat|nested] 5+ messages in thread

* bug#25293: More descriptive page titles in documentation?
  2016-12-29 18:43 bug#25293: More descriptive page titles in documentation? saffronsnail
@ 2017-01-09 21:56 ` Andy Wingo
  2017-03-01 14:49   ` Andy Wingo
       [not found]   ` <87mvd5f3wk.fsf@pobox.com>
  0 siblings, 2 replies; 5+ messages in thread
From: Andy Wingo @ 2017-01-09 21:56 UTC (permalink / raw)
  To: saffronsnail; +Cc: 25293

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





^ permalink raw reply	[flat|nested] 5+ messages in thread

* bug#25293: More descriptive page titles in documentation?
  2017-01-09 21:56 ` Andy Wingo
@ 2017-03-01 14:49   ` Andy Wingo
       [not found]   ` <87mvd5f3wk.fsf@pobox.com>
  1 sibling, 0 replies; 5+ messages in thread
From: Andy Wingo @ 2017-03-01 14:49 UTC (permalink / raw)
  To: bug-texinfo; +Cc: saffronsnail, 25293

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





^ permalink raw reply	[flat|nested] 5+ messages in thread

* bug#25293: More descriptive page titles in documentation?
       [not found]   ` <87mvd5f3wk.fsf@pobox.com>
@ 2017-03-01 18:40     ` Gavin Smith
       [not found]     ` <CAKPWYQ1GcxJ2OvQuUEVjT9+X-Y+f00HXvvm22b=w4OBnwURwRA@mail.gmail.com>
  1 sibling, 0 replies; 5+ messages in thread
From: Gavin Smith @ 2017-03-01 18:40 UTC (permalink / raw)
  To: Andy Wingo; +Cc: Bryan Ferris, 25293, Texinfo

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.





^ permalink raw reply	[flat|nested] 5+ messages in thread

* bug#25293: More descriptive page titles in documentation?
       [not found]     ` <CAKPWYQ1GcxJ2OvQuUEVjT9+X-Y+f00HXvvm22b=w4OBnwURwRA@mail.gmail.com>
@ 2017-03-01 20:55       ` Andy Wingo
  0 siblings, 0 replies; 5+ messages in thread
From: Andy Wingo @ 2017-03-01 20:55 UTC (permalink / raw)
  To: Gavin Smith; +Cc: Bryan Ferris, 25293-done, Texinfo

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





^ permalink raw reply	[flat|nested] 5+ messages in thread

end of thread, other threads:[~2017-03-01 20:55 UTC | newest]

Thread overview: 5+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2016-12-29 18:43 bug#25293: More descriptive page titles in documentation? saffronsnail
2017-01-09 21:56 ` Andy Wingo
2017-03-01 14:49   ` Andy Wingo
     [not found]   ` <87mvd5f3wk.fsf@pobox.com>
2017-03-01 18:40     ` Gavin Smith
     [not found]     ` <CAKPWYQ1GcxJ2OvQuUEVjT9+X-Y+f00HXvvm22b=w4OBnwURwRA@mail.gmail.com>
2017-03-01 20:55       ` Andy Wingo

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).