This is very much a work in progress right now. I haven't even run a
spell checker over it and not all knobs are documented.
Details
- Reviewers
mat 0mp - Commits
- rD51721: Document USES=cargo in the Porter's Handbook
Diff Detail
- Repository
- rD FreeBSD doc repository - subversion
- Lint
No Lint Coverage - Unit
No Test Coverage - Build Status
Buildable 16678 Build 16582: arc lint + arc unit
Event Timeline
Great job!
en_US.ISO8859-1/books/porters-handbook/special/chapter.xml | ||
---|---|---|
937 | I'd be more specific. The generated Cargo crates information does not go into the Makefile unless the porter actually redirects the output of make cargo-crates to Makefile. It's a small thing, however. | |
977 | This is not all. Now the porter should run make cargo-crates-licenses and probably add a LICENSE block looking more or less like this: LICENSE= APACHE20 MIT UNLICENSE LICENSE_COMB= multi |
en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml | ||
---|---|---|
244–245 | Add an <xref linkend="xxx"> to the real documentation, so that people who get here find it. |
en_US.ISO8859-1/books/porters-handbook/special/chapter.xml | ||
---|---|---|
937 | Ok, I'll reword this slightly. | |
977 | I plan on adding an example for cargo-crates-licenses. But I intentionally left out the LICENSE* bits in the current example. It is already document in detail in the licenses chapter, so I feel like this does not belong here. |
en_US.ISO8859-1/books/porters-handbook/special/chapter.xml | ||
---|---|---|
822 | that use <application>Cargo</application> | |
999 | missing blank line before and after the <para>. | |
1005–1007 | blank lines. | |
1016 | of this command I don't think it adds anything to repeat it. | |
1016–1017 | blank lines. | |
1039–1040 | blank lines. | |
1041 | clean is of no use here. | |
1057–1059 | blank lines. | |
1106 | blank line. |
- Add missing blank lines
- Improve wording in some places
- Move make clean to a separate step
There are a few other whitespace inconsistencies, I think installing textproc/igor and running it on the file igor -R en_US.ISO8859-1/books/porters-handbook/special/chapter.xml (and maybe also run igor -yR en_US.ISO8859-1/books/porters-handbook/special/chapter.xml to get style corrections.)
en_US.ISO8859-1/books/porters-handbook/special/chapter.xml | ||
---|---|---|
832–833 | Might be a good idea to add a third column in the middle "default" to put all the default values in it instead of having them mixed with the description of the variables. | |
870 | <varname>MAKE_ENV</varname> | |
891 | <package role="port">lang/rust</package> | |
915 | Use the default <buildtarget>do-install</buildtarget>. | |
984 | s/distfile/distribution file/ | |
985 | Remove extra newline before </para>. | |
1078 | Remove extra blank line. |
- Add default column for all variables
- Fix markup as noted by @mat
- s/distfile/distribution file/
- Pet igor
en_US.ISO8859-1/books/porters-handbook/special/chapter.xml | ||
---|---|---|
834 | I don't fancy "Means" here, each time I read it, I stop and wonder what resources/wealth have to do about it. I think most table listing variables have "Description" here, I think it would be a bit more clear. |
other than that, I don't see anything inherently wrong about it, it builds, so if it is complete, do ship it :-)