diff docs/man/man8/check-ports.rst @ 360:b15aeca6e433

Man: More detailed examples for "check-ports"
author Franz Glasner <fzglas.hg@dom66.de>
date Sun, 11 Dec 2022 15:28:25 +0100
parents f98622ae852c
children 30ff08fb7442
line wrap: on
line diff
--- a/docs/man/man8/check-ports.rst	Sat Dec 10 13:27:30 2022 +0100
+++ b/docs/man/man8/check-ports.rst	Sun Dec 11 15:28:25 2022 +0100
@@ -132,7 +132,8 @@
      FreeBSD        : 20210325          = up-to-date with remote
    #
 
-The standard output is::
+The standard output considers installed packages with versions that differ in any of
+the configured repositories *including*  a ports INDEX::
 
    # check-ports
    tdb                                  1.4.3,1           (FreeBSD)
@@ -141,10 +142,15 @@
    tevent                               0.10.2_1          (FreeBSD)
      INDEX          : 0.13.0_1          < needs updating (index has 0.13.0_1)
      FreeBSD        : 0.13.0            < needs updating (remote has 0.13.0)
+   tex-xetex                            0.99993_1         (FreeBSD)
+     INDEX          : 0.99993_2         < needs updating (index has 0.99993_2)
+     FreeBSD        : 0.99993_1         = up-to-date with remote
+   texlive-base                         20210325_5        (FreeBSD)
+     INDEX          : 20210325_10       < needs updating (index has 20210325_10)
+     FreeBSD        : 20210325_8        < needs updating (remote has 20210325_8)
    #
 
-
-::
+The effect of an additional :option:`-v` on :command:`check-ports` is::
 
    # check-ports -v
    tdb                                  1.4.3,1           (FreeBSD)
@@ -155,9 +161,28 @@
      INDEX          : 0.13.0_1          < needs updating (index has 0.13.0_1)
      FreeBSD        : 0.13.0            < needs updating (remote has 0.13.0)
    tex-basic-engines                    20210325          (FreeBSD)
+   tex-dvipdfmx                         20210325          (FreeBSD)
+   tex-dvipsk                           2021.1            (FreeBSD)
+   tex-formats                          20210325_1        (FreeBSD)
+   tex-jadetex                          3.13_4            (FreeBSD)
+   tex-kpathsea                         6.3.3             (FreeBSD)
+   tex-libtexlua                        5.3.6             (FreeBSD)
+   tex-libtexluajit                     2.1.0             (FreeBSD)
+   tex-luatex                           1.12.0            (FreeBSD)
+   tex-ptexenc                          1.3.9             (FreeBSD)
+   tex-synctex                          2.0.0_1           (FreeBSD)
+   tex-web2c                            20210325          (FreeBSD)
+   tex-xdvik                            22.87.06          (FreeBSD)
+   tex-xetex                            0.99993_1         (FreeBSD)
+     INDEX          : 0.99993_2         < needs updating (index has 0.99993_2)
+     FreeBSD        : 0.99993_1         = up-to-date with remote
+   tex-xmltex                           1.9_3             (FreeBSD)
+   texlive-base                         20210325_5        (FreeBSD)
+     INDEX          : 20210325_10       < needs updating (index has 20210325_10)
+     FreeBSD        : 20210325_8        < needs updating (remote has 20210325_8)
    #
 
-::
+The :option:`-s` suppresses the output if only the version of a ports INDEX differs::
 
    # check-ports -s
    tdb                                  1.4.3,1           (FreeBSD)
@@ -171,7 +196,7 @@
      FreeBSD        : 20210325_8        < needs updating (remote has 20210325_8)
    #
 
-::
+The effect of an additional :option:`-v` on :command:`checkports -s` is::
 
    # check-ports -sv
    tdb                                  1.4.3,1           (FreeBSD)
@@ -182,6 +207,23 @@
      INDEX          : 0.13.0_1          < needs updating (index has 0.13.0_1)
      FreeBSD        : 0.13.0            < needs updating (remote has 0.13.0)
    tex-basic-engines                    20210325          (FreeBSD)
+   tex-dvipdfmx                         20210325          (FreeBSD)
+   tex-dvipsk                           2021.1            (FreeBSD)
+   tex-formats                          20210325_1        (FreeBSD)
+   tex-jadetex                          3.13_4            (FreeBSD)
+   tex-kpathsea                         6.3.3             (FreeBSD)
+   tex-libtexlua                        5.3.6             (FreeBSD)
+   tex-libtexluajit                     2.1.0             (FreeBSD)
+   tex-luatex                           1.12.0            (FreeBSD)
+   tex-ptexenc                          1.3.9             (FreeBSD)
+   tex-synctex                          2.0.0_1           (FreeBSD)
+   tex-web2c                            20210325          (FreeBSD)
+   tex-xdvik                            22.87.06          (FreeBSD)
+   tex-xetex                            0.99993_1         (FreeBSD)
+   tex-xmltex                           1.9_3             (FreeBSD)
+   texlive-base                         20210325_5        (FreeBSD)
+     INDEX          : 20210325_10       < needs updating (index has 20210325_10)
+     FreeBSD        : 20210325_8        < needs updating (remote has 20210325_8)
    #