Subject: [bug#74340] Subject: [PATCH 1/1] gnu: Add stdman

From: Noé Lopez <[email-masked]>
Date: Thu, 14 Nov 2024 17:05:51 +0100

Hi,

Thank you for your patch, the package works well but there are a few
style errors:

> * gnu/packages/documentation.scm (stdman): New variable.
> 
> Change-Id: I4ed70b6ad4208bde4df13d45fd7241096f2469a1
> ---
>   gnu/packages/documentation.scm | 25 +++++++++++++++++++++++++
>   1 file changed, 25 insertions(+)
> 
> diff --git a/gnu/packages/documentation.scm b/gnu/packages/documentation.scm
> index f0e37561f7..928e022239 100644
> --- a/gnu/packages/documentation.scm
> +++ b/gnu/packages/documentation.scm
> @@ -14,6 +14,7 @@
>   ;;; Copyright © 2022 Maxim Cournoyer <[email-masked]>
>   ;;; Copyright © 2023 Janneke Nieuwenhuizen <[email-masked]>
>   ;;; Copyright © 2024 Felix Gruber <[email-masked]>
> +;;; Copyright © 2024 Tomás Ortín Fernández <[email-masked]>
>   ;;;
>   ;;; This file is part of GNU Guix.
>   ;;;
> @@ -566,3 +567,27 @@ (define-public stddoc
>   supported programming languages.  Markdeep code comments are extracted 
> from stdin and
>   printed into stdout as a HTML file.")
>         (license license:unlicense))))
> +
> +(define-public stdman
> +  (let ((commit "b7070fe10143411a8d69fe3a9f75e90008a8386d")
> +	(revision "0")) ;; Last release is outdated
> +    (package
> +      (name "stdman")
> +      (version (git-version "20240610" revision commit))
> +      (source (origin
> +		(method git-fetch)
> +		(uri (git-reference
> +		      (commit commit)
> +		      (url "https://github.com/jeaye/stdman")))
> +		(sha256
> +		 (base32 "0h1gfw4sxic5gx073zmshg4qyz2g142ckgzyj30pk8j708mnl8pz"))))
> +      (build-system gnu-build-system)
> +      (arguments
> +       (list
> +	#:tests? #f ;; There are no tests

There should be a dot at the end of comments, and only one semicolon if
it’s a margin comment.

> +	#:phases #~(modify-phases %standard-phases
> +		     (delete 'build))))
> +      (description "Formatted C++ @code{stdlib} man pages from 
> cppreference")
> +      (synopsis "stdman is a tool that provides C++ @code{stdlib} 
> documentation archived from cppreference as groff-formated man pages, 
> accessible from the @code{man} command.")

Description and synopsis are swapped (synopsis should be the small one).

> +      (home-page "https://github.com/jeaye/stdman")
> +      (license license:expat))))
> 
> base-commit: 1f057603ef59c7b9c32f610a897321fd75dc4dad
> -- 
> 2.46.0

I’m sending an updated patch with these small modifications.

Have a good day,
Noé