[pacman-dev] [PATCH 2/3] doc: reference all libalpm sections within libalpm man page

[Emil Velikov]

On Mon, 11 Jan 2021 at 01:15, Allan McRae <allan at archlinux.org> wrote:
>
> On 10/1/21 10:34 pm, Emil Velikov wrote:
> > Hi Allan,
> >
> > Just a couple of ideas:
> >
> > On Fri, 8 Jan 2021 at 23:29, Allan McRae <allan at archlinux.org> wrote:
> >>
> >> Also, fix minor typo.
> >>
> >> Signed-off-by: Allan McRae <allan at archlinux.org>
> >> ---
> >>  lib/libalpm/alpm.h | 15 ++++++++++-----
> >>  1 file changed, 10 insertions(+), 5 deletions(-)
> >>
> >> diff --git a/lib/libalpm/alpm.h b/lib/libalpm/alpm.h
> >> index 171cf740..69603b15 100644
> >> --- a/lib/libalpm/alpm.h
> >> +++ b/lib/libalpm/alpm.h
> >> @@ -48,15 +48,20 @@ extern "C" {
> >>   *
> >>   *
> >>   *
> >> - * libalpm is a package management library, primaraly used by
> >> + * libalpm is a package management library, primarily used by pacman.
> >>   * For ease of access, the libalpm manual has been split up into several sections.
> >>   *
> >>   * @section see_also See Also
> >>   * \b libalpm_list(3),
> > Worth keeping this sorted in the libalpm list below?
> >
>
> I kept libalpm_list first, as it is a structure that is needed for
> almost everything else.   I think this makes sense...

I see it does. Fwiw without a separation (say a mini-heading for
structs, functions) my brain goes into durp mode assuming the whole
thing is alpha-sorted.
Anywho, I'd call that an user issue ;-)

HTH
Emil