doc: Discourage ambiguous package names.
* doc/contributing.texi (Package Naming): Explicitly mention single-character and otherwise ambiguous names.
This commit is contained in:
parent
673031c762
commit
1b1a61f86a
@ -445,6 +445,14 @@ the project name chosen upstream, with underscores replaced with
|
||||
hyphens. For instance, GNUnet is available as @code{gnunet}, and
|
||||
SDL_net as @code{sdl-net}.
|
||||
|
||||
A noteworthy exception to this rule is when the project name is only a
|
||||
single character, or if an older maintained project with the same name
|
||||
already exists---regardless of whether it has already been packaged for
|
||||
Guix. Use common sense to make such names unambiguous and meaningful.
|
||||
For example, Guix's package for the shell called ``s'' upstream is
|
||||
@code{s-shell} and @emph{not} @code{s}. Feel free to ask your fellow
|
||||
hackers for inspiration.
|
||||
|
||||
We do not add @code{lib} prefixes for library packages, unless these are
|
||||
already part of the official project name. But @pxref{Python
|
||||
Modules} and @ref{Perl Modules} for special rules concerning modules for
|
||||
|
@ -49,7 +49,7 @@ Copyright @copyright{} 2017, 2021 Christopher Lemmer Webber@*
|
||||
Copyright @copyright{} 2017, 2018, 2019, 2020 Marius Bakke@*
|
||||
Copyright @copyright{} 2017, 2019, 2020 Hartmut Goebel@*
|
||||
Copyright @copyright{} 2017, 2019, 2020, 2021 Maxim Cournoyer@*
|
||||
Copyright @copyright{} 2017, 2018, 2019, 2020 Tobias Geerinckx-Rice@*
|
||||
Copyright @copyright{} 2017, 2018, 2019, 2020, 2021 Tobias Geerinckx-Rice@*
|
||||
Copyright @copyright{} 2017 George Clemmer@*
|
||||
Copyright @copyright{} 2017 Andy Wingo@*
|
||||
Copyright @copyright{} 2017, 2018, 2019, 2020 Arun Isaac@*
|
||||
|
Loading…
Reference in New Issue
Block a user