Bug 271534 - "4.4.11. Restoring the Package Database" from the FreeBSD handbook is outdated
Summary: "4.4.11. Restoring the Package Database" from the FreeBSD handbook is outdated
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: freebsd-doc (Nobody)
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2023-05-20 16:17 UTC by Aaron Lopez
Modified: 2023-07-17 16:00 UTC (History)
2 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
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.