Bug 271534

Summary: "4.4.11. Restoring the Package Database" from the FreeBSD handbook is outdated
Product: Documentation Reporter: Aaron Lopez <vieroninfo>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Some People CC: carlavilla, freebsd
Priority: ---    
Version: Latest   
Hardware: Any   
OS: Any   
See Also: https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=269810

Description Aaron Lopez 2023-05-20 16:17:59 UTC 
Hi guys,
apparently "4.4.11. Restoring the Package Database" from the FreeBSD handbook is outdated. As pointed out to me, the "pkg backup" command was removed with the following commit in "https://github.com/freebsd/pkg" which also contains the reason for its removal. So I guess that section should be removed or updated.

-----------------------------
commit eea1a990eb1187a408811534a5060e58074a9044
Author: Baptiste Daroussin <bapt@FreeBSD.org>
Date:   Tue Oct 4 17:02:13 2022 +0200

    backup: remove the backup command which was confusing

    backup and backup -r was basically replicating the db, while we now
    prefer a real sql dump.

    with the backup command backuping a corrupted db will succesfully
    backup it and pkg backup -r will sucessfully restore a corrupted db.
    Making its usage quite useless.
-----------------------------


Thank you for your attention.
Kind regards
Comment 1 commit-hook freebsd_committer freebsd_triage 2023-07-17 15:59:43 UTC 
A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/doc/commit/?id=54c0945f7dab278705311e5be394347b3d629b58

commit 54c0945f7dab278705311e5be394347b3d629b58
Author:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
AuthorDate: 2023-07-17 15:51:49 +0000
Commit:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
CommitDate: 2023-07-17 15:51:49 +0000

    Handbook - ports: Remove pkg backup from ports chapter

    pkg backup command was remove in [1]

    PR:                     271534
    Submitted by:           Aaron Lopez <vieroninfo@gmail.com>

    [1] https://github.com/freebsd/pkg/commit/eea1a990eb1187a408811534a5060e58074a9044

 .../content/en/books/handbook/ports/_index.adoc    | 32 ----------------------
 1 file changed, 32 deletions(-)
Comment 2 Sergio Carlavilla Delgado freebsd_committer freebsd_triage 2023-07-17 16:00:28 UTC 
Since pkg removed the command, I remove it from the documentation too.