Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 03 Nov 2020 18:47:43 +0000
From:      bugzilla-noreply@freebsd.org
To:        doc@FreeBSD.org
Subject:   [Bug 250834] pkg-create(8) description of manifest file is outdated
Message-ID:  <bug-250834-9@https.bugs.freebsd.org/bugzilla/>

next in thread | raw e-mail | index | archive | help
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D250834

            Bug ID: 250834
           Summary: pkg-create(8) description of manifest file is outdated
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Some People
          Priority: ---
         Component: Manual Pages
          Assignee: bugs@FreeBSD.org
          Reporter: pfm@wp.eu
                CC: doc@FreeBSD.org

Manual page for the pkg-create utility
(https://www.freebsd.org/cgi/man.cgi?pkg%2Dcreate) describes +MANIFEST file
details, but it mentions a 'file' clause, while it should be 'files' follow=
ed
by a collection of files enclosed in braces, as described on Microsoft Gith=
ub
project page of pkg utility (see section "Manifest":
https://github.com/freebsd/pkg#manifest).

In my opinion, "MANIFEST FILE DETAILS" section of the manual page could sta=
rt
with at least one sentence of introduction, like:

> +MANIFEST file uses UCL, the Universal Configuration Language. See an exa=
mple in the EXAMPLES section.

And then, I would introduce an "EXAMPLES" section like in many other FreeBSD
manual pages, just copy-pasting the example from Microsoft Github page link=
ed
above.

Wiki page https://wiki.freebsd.org/pkgng is also outdated and suggests that
+MANIFEST is a YAML file.

--=20
You are receiving this mail because:
You are on the CC list for the bug.=



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bug-250834-9>