Page MenuHomeFreeBSD

address bug 206078 - Reference to deleted port
ClosedPublic

Authored by jgh on Jan 29 2016, 6:01 AM.
Tags
None
Referenced Files
Unknown Object (File)
Thu, Dec 5, 2:10 AM
Unknown Object (File)
Sat, Nov 30, 1:38 PM
Unknown Object (File)
Sun, Nov 17, 1:40 PM
Unknown Object (File)
Sun, Nov 17, 12:42 PM
Unknown Object (File)
Oct 20 2024, 7:51 AM
Unknown Object (File)
Oct 2 2024, 6:54 PM
Unknown Object (File)
Sep 21 2024, 3:42 PM
Unknown Object (File)
Sep 17 2024, 3:43 AM
Subscribers
None

Details

Summary
Test Plan

Diff Detail

Repository
rD FreeBSD doc repository - subversion
Lint
Lint Skipped
Unit
Tests Skipped
Build Status
Buildable 2307
Build 2316: Jenkins Build DocJenkins

Event Timeline

jgh retitled this revision from to address bug 206078.
jgh updated this object.
jgh edited the test plan for this revision. (Show Details)
jgh added reviewers: bcr, wblock, remko.
jgh set the repository for this revision to rD FreeBSD doc repository - subversion.
jgh retitled this revision from address bug 206078 to address bug 206078 - Reference to deleted port.

Minor edits. Have you tested the use of mkfontdir as it is shown?

handbook/x11/chapter.xml
977

This sentence is mostly redundant. I'd say we can just eliminate most of it:

<command>mkfontdir</command> can be installed
as a package:</para>

The procedure was tested as part of the documentation change.

handbook/x11/chapter.xml
977

With all due respect, I don't see how this is redundant as the documentation is shifting to instructions. If I remove this line, then there is a gap on what the next line is achieving. If I proceed with leaving a gap, then I am assuming the audience knows how to install a package, which I believe is what we aim not to do. Perhaps I am being overly particular in assuming that if it reads 'pkg install,' that our readers would assume that is how you install a package. I'm trying to avoid that assumption.

handbook/x11/chapter.xml
977

The redundant part is telling the reader that the software is available, and that it can be a package or port. Showing them how to install it answers those questions.

The sentence that shows the installation could be better. Some readers are going to miss that "or". Really, it is not necessary to have both. Pick the simpler way (a package) and just show that, and it eliminates a lot of explanation and uncertainty.

jgh edited edge metadata.

address comments

wblock edited edge metadata.
This revision is now accepted and ready to land.Jan 29 2016, 7:19 PM
This revision was automatically updated to reflect the committed changes.