Page MenuHomeFreeBSD

Add a chapter about installing packages from a DVD disk
Needs ReviewPublic

Authored by AMDmi3 on Mar 16 2016, 5:48 PM.
Tags
None
Referenced Files
Unknown Object (File)
Apr 12 2024, 9:40 AM
Unknown Object (File)
Mar 14 2024, 2:44 AM
Unknown Object (File)
Jan 10 2024, 8:52 PM
Unknown Object (File)
Jan 2 2024, 4:10 PM
Unknown Object (File)
Dec 25 2023, 7:50 PM
Unknown Object (File)
Nov 10 2023, 7:34 PM
Unknown Object (File)
Nov 9 2023, 10:41 PM
Unknown Object (File)
Nov 8 2023, 7:24 PM
Subscribers

Details

Reviewers
brd
Summary

I've encountered people on forums who need to install FreeBSD packages completely offline. Since the process is not quite straightforward, I think handbook chapter for this may be useful. Proofreading from native English speaker required.

Compiled version:
https://people.freebsd.org/~amdmi3/handbook/pkgng-intro.html#pkgng-dvd

Diff Detail

Event Timeline

AMDmi3 retitled this revision from to Add a chapter about installing packages from a DVD disk.
AMDmi3 updated this object.
AMDmi3 edited the test plan for this revision. (Show Details)
This comment was removed by AMDmi3.
wblock added inline comments.
en_US.ISO8859-1/books/handbook/ports/chapter.xml
715

The aside (in parens) is an interruption, and it can be rearranged to avoid that interruption:

Packages can be installed from media like <acronym>DVD</acronym> disks or images.
718

This whole sentence contains several different ideas which should be split up.

  • packages can be installed from media
  • a network connection is then not needed
  • the packages might be older or outdated
720

This seems overly specific. We can probably just say that the media must be mounted.

726

"Not" looks wrong.

730

A lot of these sentences are if/then, with a pause between the two. These are somewhat halting to read. Try to use sentences without those pauses:

<command>pkg</command> can be used normally as long as REPOS_DIR is set.
731
732

Sorry, it is hard to understand what this means.

759

There should be some type of conclusion at the end of this.

AMDmi3 added inline comments.
en_US.ISO8859-1/books/handbook/ports/chapter.xml
720

Not really, because repository configuration file on DVD has /dist path hardcoded. I think it needs an explanation instead of that (or why) this specific path is required.

en_US.ISO8859-1/books/handbook/ports/chapter.xml
718

"though" would have commas around it, but can better be removed. Also s/may/might/, and "it should be noted" is not really needed at all. So:

Only a subset of packages are available this way, and those packages might be outdated.
722

Again, this is an if/then sentence with a pause in the middle. Two of them, really. (Ignoring wrapping...)

Media to be used as a local package repository must be mounted on <filename>/dist</filename>.
724

The second sentence that explains why /dist must be used does not really explain why. Where is it hardcoded?

726

This example should be preceded by a sentence that explains that this example shows mounting a DVD containing pacakges. It should also point out that on this DVD, those packages are in the root, as opposed to wherever they are on an install DVD.

730

Another if/then sentence with a pause. How about

Set <envar>REPOS_DIR</envar> to ... to point &man.pkg.1; to the new package repository.

or

Point &man.pkg.1; to the new repository by setting <envar>REPOS_DIR<envar> to ...

Not sure how this interacts with the requirement of /dist.

732

Needs an article here ("the"), but it's also not clear.

761

The meaning of "bootstrapped" here might not be clear, but otherwise very nice!