search

pgf-tikz / pgfplots

pgfplots - A TeX package to draw normal and/or logarithmic plots directly in TeX in two and three dimensions with a user-friendly interface and pgfplotstable - a TeX package to round and format numerical tables. Examples in manuals and/or on web site.
http://pgfplots.sourceforge.net/
187 stars 33 forks source link

Inconsistent naming convention for keys/options? #474

Open user202729 opened 2 months ago

user202729 commented 2 months ago

e.g.

image

There are spaces in enlarge x limits, but not in clip xlimits or enlargelimits.

(Initially pointed out in https://tex.stackexchange.com/a/64236/250119 .)

Mo-Gul commented 2 months ago

It's true that some key names are inconsistent. But I'll argument that these appeared over time when most likely the development of the package was done by a single person. In the meantime there is too much code out there that uses this inconsistent naming scheme, so changing the names is not an option until v2 (where breaking changes would be allowed).

So for now the only option would be to add keys with consistent names. For that (i.e. aliases) you'll find already some in the manual, e.g. (x|y|z)ticklabel style and (x|y|z) tick label style`.

Feel free to provide a PR.

hmenke commented 2 months ago

This issue is well known, but unfortunately due to the age and spread of pgfplots it has become essentially unfixable. We could provide aliases for all the keys with maybe more sensible/consistent names, but I think pgfplots already has more than enough keys as it is.

user202729 commented 2 months ago

I think having lots of deprecated key is not really a problem as long as they don't appear in the manual (except possibly in "Deprecated keys" section)?