Home > mailing lists

Get rid of "Section.N.N.N" on DOCs - Mailing list pgsql-hackers

From	Marcos Pegoraro
Subject	Get rid of "Section.N.N.N" on DOCs
Date	December 14 20:30:07
Msg-id	CAB-JLwa7XLuMBH5sqwue+tFEDyPWDVMk9ufBGjCB6fAOAUTQ4A@mail.gmail.com Whole thread Raw
Responses	Re: Get rid of "Section.N.N.N" on DOCs Re: Get rid of "Section.N.N.N" on DOCs Re: Get rid of "Section.N.N.N" on DOCs
List	pgsql-hackers

When reading documentation all the time we get something like
See Section 27.4.5 and Section 27.4.2 for details.

The only way to know what it is that Section is opening and reading its title.

Wouldn't it be better if we print somethink for better reading like this ?

There are places where links are mixed, some of them are auto explanatory, some don't, like on See Also of VACUUM

For that we need only put a "xreflabel" tag on that target link.

I can create a patch for all of them, but I would like to know why it's done this way.

regards

Marcos

From: "Jelte Fennema-Nio"
Date: 14 December, 19:56:23
Subject: Re: Make copyObject work in C++

From: "David G. Johnston"
Date: 14 December, 20:35:17
Subject: Re: Get rid of "Section.N.N.N" on DOCs