basho / cuttlefish

never lose your childlike sense of wonder baby cuttlefish, promise me?
Apache License 2.0
205 stars 124 forks source link

Added @see annotation to schemas #88

Closed joedevivo closed 10 years ago

joedevivo commented 10 years ago

Sometimes you only want to write the docs once. I'm looking at you @Vagabond.

Check this schema

%% @doc A really long winded description of this configuration value
%% but it also applies to others! I really don't want to type it again
{mapping, "setting.one", "erlang.key", []}.

%% @see setting.one
{mapping, "setting.one", "erlang.key2", []}.

Now ./riak config describe setting.two will display the docs for setting.one.

If you have an @doc and an @see It will print the @doc for the setting you're querying, and the @see list of other variables to use.

Only one @see per line. If you want more than one:

%% @see setting.one
%% @see setting.two
seancribbs commented 10 years ago

+:100: