Page MenuHomeFreeBSD

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

Authored by mat on Aug 20 2014, 3:06 PM.
Tags
None
Referenced Files
F83105924: D647.id.diff
Mon, May 6, 8:37 AM
Unknown Object (File)
Sat, May 4, 4:39 AM
Unknown Object (File)
Thu, May 2, 6:56 PM
Unknown Object (File)
Thu, May 2, 7:47 AM
Unknown Object (File)
Wed, May 1, 12:25 AM
Unknown Object (File)
Sun, Apr 28, 3:04 PM
Unknown Object (File)
Sat, Apr 20, 10:16 PM
Unknown Object (File)
Feb 20 2024, 8:22 PM
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 [porting-dads] igor -Ry and some other rewording and fixes..
mat updated this object.
mat edited the test plan for this revision. (Show Details)
antoine added inline comments.
en_US.ISO8859-1/books/porters-handbook/porting-dads/chapter.xml
536–537

the strings?

wblock added inline comments.
en_US.ISO8859-1/books/porters-handbook/porting-dads/chapter.xml
536–537

It's a little ambiguous. Maybe "any of these strings".

Also, s/note/not/

537

"should be" is okay here, it is making a recommendation. But this sentence is vague. It's hard to tell what it is saying. The string should be different... from what? I think it is saying that the wording of the message depends on which variable is used. The example shows that BROKEN and IGNORE are worded differently.

Rewords a bit after antoine and wblock's comments

en_US.ISO8859-1/books/porters-handbook/porting-dads/chapter.xml
38

The <filename>pkg-<replaceable>*</replaceable></filename> files can be modified by <link linkend="pkg-names">redefining a variable</link> rather than overwriting the file.

67

Some code needs modifications or

192

The rest of the sentence starting with "and" seems unnecessary here.

Also, if we must include smileys, they should probably be &#x263A;.

220

s/resaonnable/reasonable/

221

s/,//

284

Break sentence at semicolon.

311

s/System/The system/

347

Do send applicable changes and patches to the upstream

348

maintainer for inclusion in the next release of the code.

349

This makes the next release that much easier.

380

s/cases/cases,/

381

There are several variables that can be used in a port's <filename>Makefile</filename> to tell the user that the port cannot be installed.

384

<command>make</command> is not really needed here.

385

s/given back/shown/

386

Remove <command>make</command>.

387

variable. Each variable conveys radically different

388

meanings, both to users and to automated systems that depend on

389

"the" is not needed here.

524

"it will be checked" is ambiguous.

If this variable is set, <filename>/usr/lib32</filename> must be present for IA32 versions of libraries and the kernel must support IA32 compatibility.

538

Due to the way the information is shown to the user, the wording of messages for each variable differ:</para>

637

s/Check/Verify/

650

s/Maybe also contact/Contact/

658

Break sentence after "information".

661

The quotes seem unnecessary.

to get the executable name.

663

s/behaviour/behavior/

709

Break sentence after "way".

en_US.ISO8859-1/books/porters-handbook/porting-dads/chapter.xml
220

Spelling: s/reasonnable/reasonable/

mat updated this revision to Diff 1641.

Closed by commit rD45618 (authored by @mat).