The Rust Reference lacks a table of contents

[tomjakubowski]

The full table of contents in the manual (v0.11)¹ made it much easier to navigate than the new Rust Reference. A long, highly structured document like the Reference needs a full table of contents to be most useful.

¹ the kinda ugly line spacing bug was later fixed I'm pretty sure.

[steveklabnik]

👍 for sure.

[nodakai]

I really miss the detailed TOC of the language reference. Cf., eg.

• http://www.gnu.org/software/make/manual/make.html

It also served me as an index.

[huonw]

The sections are all there, just hidden by CSS; the old manual has some custom CSS to override this and display them all.

[adrientetar]

Yes it had some CSS injected in the Makefile via --include-in-header (just a pointer if someone wants to take this on).
The include file is still present: https://github.com/rust-lang/rust/blob/master/src/doc/full-toc.inc

It's just a matter of adding it back to the Makefile.

[gamazeps]

Thanks for the pointer, I'll look at it tonight.

But if someone wants to tackle it before, feel free :p

[gamazeps]

@adrientetar it's stilll called in the makefile, I'll look at the diffs to see what changed :/

[adrientetar]

@gamazeps At lines 36-37, rename RUSTDOC_{…}_rust to RUSTDOC_{…}_reference, that’s because rust.md was renamed to reference.md.
Also can you remove rust at line 31? Steve didn’t remove it when he changed the Makefile.

[steveklabnik]

Ahhhhh so that's what it is. Whoops!

Sent from my iPhone

On Nov 6, 2014, at 21:33, Adrien Tétar notifications@github.com wrote:

@gamazeps At lines 36-37, rename RUSTDOC_{…}rust to RUSTDOC{…}_reference, that’s because rust.md was renamed to reference.md.
Also can you remove rust at line 31? Steve didn’t remove it when he changed the Makefile.

—
Reply to this email directly or view it on GitHub.