Page MenuHomeFreeBSD

[upgrading] igor -Ry and some other rewording and fixes.
ClosedPublic

Authored by mat on Aug 20 2014, 3:09 PM.
Tags
None
Referenced Files
Unknown Object (File)
Dec 19 2023, 3:52 PM
Unknown Object (File)
Nov 22 2023, 5:08 AM
Unknown Object (File)
Nov 16 2023, 9:28 AM
Unknown Object (File)
Nov 11 2023, 6:29 PM
Unknown Object (File)
Nov 11 2023, 4:46 AM
Unknown Object (File)
Nov 7 2023, 4:57 PM
Unknown Object (File)
Nov 7 2023, 6:43 AM
Unknown Object (File)
Nov 7 2023, 12:39 AM
Subscribers

Diff Detail

Repository
rD FreeBSD doc repository - subversion
Lint
No Lint Coverage
Unit
No Test Coverage

Event Timeline

mat retitled this revision from to [upgrading] igor -Ry and some other rewording and fixes..
mat updated this object.
mat edited the test plan for this revision. (Show Details)
wblock added inline comments.
en_US.ISO8859-1/books/porters-handbook/upgrading/chapter.xml
16

<acronym> tags on FTP.

29–33

It would be better not to mention the particular bug tracking software. Also probably should mention it by both names: the PR or bug database.

107–108

s/us//

108–111

send-pr is gone.

167

Break sentence on semicolon.

183–184

s/ports/port/

199–200

s/try/attempt/

200–201

Break sentence on semicolon.

221–222

The paren must not be followed by a space.

247

s/how a port must be,/the structure of a port,/

265–267

s/Patch/The patch/

273

Could probably remove "The Files" here.

281

s/documented this in this/documented in this/

300

"As shown, the command will only work with ..."

301

s/This will work with both/Instead, use the form shown below, which will work with both/

334–335

s/order/order,/

335

s/New entries must be added to/New entries are added to/

335–338

with the latest entries first.</para>

Update with wblock's comments

en_US.ISO8859-1/books/porters-handbook/upgrading/chapter.xml
108–111

Oh, I did not know that, still use it myself 0:-)

121

So I guess the problem-reports article should be updated too, to trim all the references to using send-pr.

200–201

Maybe igor should try to detect that, and tell people they should make separate sentences ?

en_US.ISO8859-1/books/porters-handbook/upgrading/chapter.xml
15

This is hard to understand. I think it is trying to say "make sure that the ports tree on the local machine is current, because the port might have already been upgraded. The most recent version of ports can be found..."

But that part about where they can be found is kind of obsolete. People now should just look in the repo.

"When a port is not the most recent version available from the authors, update the local working copy of <filename>/usr/ports</filename>. The port might have already been updated to the new version."

37

s/the searching/searching/

184

Serial comma: s/moving/moving,/

en_US.ISO8859-1/books/porters-handbook/upgrading/chapter.xml
16

The addition helps, but I also meant to remove the rest of the paragraph.

wblock added a reviewer: wblock.

Please build-test and commit.

This revision is now accepted and ready to land.Sep 15 2014, 10:06 PM
mat updated this revision to Diff 1639.

Closed by commit rD45617 (authored by @mat).