Page MenuHomeFreeBSD

The original example was bad, try to make it better.
ClosedPublic

Authored by mat on Apr 14 2016, 12:53 PM.
Tags
None
Referenced Files
Unknown Object (File)
Sun, Nov 10, 5:25 PM
Unknown Object (File)
Oct 5 2024, 11:35 AM
Unknown Object (File)
Oct 5 2024, 7:56 AM
Unknown Object (File)
Oct 4 2024, 1:31 AM
Unknown Object (File)
Oct 3 2024, 11:22 AM
Unknown Object (File)
Oct 3 2024, 12:19 AM
Unknown Object (File)
Oct 1 2024, 8:06 AM
Unknown Object (File)
Oct 1 2024, 7:03 AM
Subscribers
None

Diff Detail

Repository
rD FreeBSD doc repository - subversion
Lint
Lint Not Applicable
Unit
Tests Not Applicable

Event Timeline

mat retitled this revision from to The original example was bad, try to make it better..
mat updated this object.
mat edited the test plan for this revision. (Show Details)
mat added a reviewer: wblock.
en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
1172 ↗(On Diff #15192)

variables variables is repeated repeated.

1179 ↗(On Diff #15192)

"Contains" is not needed, just "The list of supported interpreters."

1186 ↗(On Diff #15192)

"Contains" is not needed.
Not sure what "bad" means here. Obsolete? Deprecated? Will run rm -rf?

Maybe:

The list of obsolete, old-style invocations of interpreters.
1187 ↗(On Diff #15192)

The second part of this needs to be a separate sentence and is hard to understand. What will be appended to what else, and why? What is this used for?

"The SHEBANG value is compared to the obsolete/outmoded/deprecated interpreter invocations listed in interp_OLD_CMD. Then something happens (the user is warned, portlint freaks out, the time/space continuum is damaged)."

1198 ↗(On Diff #15192)

"Contains" no es necesario.

1199 ↗(On Diff #15192)

s/It has a default value of/The default value is/

1205 ↗(On Diff #15192)

Not clear what "support" means here. Is it in addition to something, or is it switching from something?

mat marked 7 inline comments as done.Apr 19 2016, 2:59 PM
mat added inline comments.
en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
1186 ↗(On Diff #15192)

The list of bad shebang lines, like /bin/bash or /usr/bin/perl

Maybe wrong is better.

mat marked an inline comment as done.
  • The original example was bad, try to make it better.
  • Update shebangfix with wblock's comments.
  • USES=tcl/tk gained tea support, while there, rewrite the whole thing, it
  • Document USES=firebird.
  • Document USES=gnome.
  • Document USES=mate.
  • Document USES=pyqt.
  • Document USES=sqlite.
  • Catch up with the different USES.
en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
464 ↗(On Diff #15389)

s/Adds/Add/

1460 ↗(On Diff #15389)

Possibly s/If the needed,/If needed,/

1742 ↗(On Diff #15389)

Use serial comma:
s/run/run,/

1853 ↗(On Diff #15389)

Is "correct" needed here? The "path to the command interpreter" is assumed to be correct.

Unless this means something more specific, like "the correct path to the command interpreter on &os;".

1862 ↗(On Diff #15389)

It might help to have a sentence that explains how they are wrong, like

<para>The list of wrong invocations of interpreters.  These are typically obsolete paths, or paths used
  on other operating systems that are incorrect on &os;.
1865 ↗(On Diff #15389)

"it" is not clear here. interp_OLD_CMD ?

mat marked 6 inline comments as done.Apr 21 2016, 1:07 PM
This revision was automatically updated to reflect the committed changes.