The N_ macro is spoiling the user documentation

[Bert Timmerman]

Generating user documentation with "--enable-doc" gives unwanted "N_" text in a lot of places in pcb.pdf.

G.1.72 SetLayertype
                                                                                         ̈
  N_("SetLayertype(layer, type)");
                                                                                       ©
   N_("Sets the type of a layer. Type can be given by name or by number. For a list of
available types, run ListLayertypes().");
   Layers can have various types, like copper, silk or outline. Behaviour of GUI and ex-
porters largely depend on these types. For example, searching for electrical connections
searches only layers of type copper, all other layers are ignored.
   For a list of available types see see Section G.1.41 [ListLayertypes Action], page 125.

G.1.73 SetOctagon
                                                                                      ̈
  N_("SetOctagon(Object|ToggleObject|SelectedElements|Selected)");

[Vladimir Zhbanov (vzhbanov)]

One of the ways to solve this is to remove N_'s and make comments for future developers to not add those strings to translation.

[Bert Timmerman (bert-timmerman)]

Starting at:

Appendix G Action Reference

G.1 Core actions

G.1.1 AddRats

N ("AddRats(AllRats|SelectedRats|Close)");

[Bert Timmerman (bert-timmerman)]

Another more cumbersome way is to move *all* user documentation related stuff into pcb.texi.

[Vladimir Zhbanov (vzhbanov)]

On Mon, Oct 12, 2015 at 05:15:22PM -0000, Bert Timmerman wrote:
> Another more cumbersome way is to move *all* user documentation related
> stuff into pcb.texi.

AFAICR, inline documentation was introduced in order to keep the docs
up-to-date.

[DJ Delorie (djdelorie)]

Right, at the moment the inline documentation is the only documentation that's actually up to date.

[Bert Timmerman (bert-timmerman)]

OK, shall I start removing the culprits ?

[Bert Timmerman (bert-timmerman)]

Fix committed to master.