Page MenuHomeFreeBSD

patches to Handbook ports section: part 2
ClosedPublic

Authored by linimon on Dec 18 2016, 8:40 PM.
Tags
None
Referenced Files
Unknown Object (File)
Tue, Apr 30, 11:20 PM
Unknown Object (File)
Tue, Apr 30, 10:45 PM
Unknown Object (File)
Tue, Apr 30, 10:45 PM
Unknown Object (File)
Tue, Apr 30, 10:45 PM
Unknown Object (File)
Tue, Apr 30, 10:45 PM
Unknown Object (File)
Tue, Apr 30, 10:45 PM
Unknown Object (File)
Tue, Apr 30, 10:45 PM
Unknown Object (File)
Tue, Apr 30, 8:25 PM
Subscribers
None

Details

Summary

This patch shuffles some text in the ports section of the Handbook.

The presentation assumes more knowledge on the part of a new user to FreeBSD than it should.

In good writing, concepts should always be introduced before being discussed. The current presentation mixes them. The new order introduces applications, then ports, then packages, and then elaborates on the difference between packages and ports.

90% of the content is merely moved. Some editing for clarity is included.

Diff Detail

Lint
Lint Skipped
Unit
Tests Skipped

Event Timeline

linimon retitled this revision from to patches to Handbook ports section: part 2.
linimon updated this object.
linimon edited the test plan for this revision. (Show Details)
linimon added reviewers: Doc Committers, wblock.
This comment was removed by linimon.
chapter.xml
102–110

Typo: adapated.

103

"...on &os;, the source code might need editing for it to install and run properly."

112

Can we remove this paragraph entirely?

844

Trying to think of a way to say this more simply. How about:
"The Ports Collection contains directories for software categories. Inside each category are subdirectories for each application. The application subdirectories contain a set..."

chapter.xml
112

Actually I believe it should remain. It introduces the concept that not every port maybe packaged.

Incorporates feedback.

Deletes a line that is now redundant (first introduction of category subdirectories). It is already explained better, below the two Procedures.

chapter.xml
824

"Each application" is repeated here, but it's not a huge thing.

  • Incorporates latest feedback
This revision was automatically updated to reflect the committed changes.