Re: [Libclc-developers] Re: clc_ultostr doc change

[regis <re...@in...>]

regis wrote:
> 
> Jan Engelhardt wrote:
> >
> > >> >With good naming conventions, you only scan the prototype in the docs
> > >> >to find what you want
> > >> >With bad ones, you must also read the full description.
> > >> >Have a look at the libncurse documentation to see what I mean.
> > >> >You really want "this" ?
> > >> >http://www.linuxbase.org/spec/refspecs/LSB_1.2.0/gLSB/libncurses.html
> > >>
> > >> The only thing I am worried about is a prefix for Ncurses.
> > >
> > >beuarhhhhh....
> >
> > Or what was it about, then?
> >
> > - Jan Engelhardt
> 
> it is unreadable and inconsistent.
> Exemples:
> 
> addchstr(): no underscore, start with the verb
> attr_get(): noun prefix + one underscore, end with the verb.
> tgetflag(): no underscore, the verb is in the middle.
> has_ic(): verb prefix +  one underscore
> move(): verb written in full
> mvaddchstr(): 'move' shrinked to 'mv'

correction: for the latter,
I'm not even able to gues what 'mv' stands for.