Page MenuHomeFreeBSD

Various updates and fixes.
ClosedPublic

Authored by mat on Jun 29 2015, 12:22 PM.
Tags
None
Referenced Files
Unknown Object (File)
Nov 19 2024, 4:56 PM
Unknown Object (File)
Nov 19 2024, 7:48 AM
Unknown Object (File)
Nov 17 2024, 1:40 PM
Unknown Object (File)
Nov 17 2024, 12:42 PM
Unknown Object (File)
Nov 4 2024, 4:01 AM
Unknown Object (File)
Oct 2 2024, 2:29 AM
Unknown Object (File)
Sep 24 2024, 7:32 AM
Unknown Object (File)
Sep 23 2024, 8:45 PM
Subscribers
None

Details

Summary

Current build is there http://aragorn.in.absolight.net/d2/various_fixes/en_US.ISO8859-1/books/porters-handbook/

  • Mention WRKSRC_SUBDIR.
  • Note that NO_WRKSUBDIR should not be used.
  • Mention USES=metaport.
  • NEED_ROOT is gone, mention USES=fakeroot.

Diff Detail

Lint
No Lint Coverage
Unit
No Test Coverage

Event Timeline

mat retitled this revision from to Various updates and fixes..
mat updated this object.
mat edited the test plan for this revision. (Show Details)
mat added reviewers: wblock, gjb.
en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
4529

"parts" is kind of vague. "source files" is more specific.

4547

Needs a comma after "build".

en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
35

The emphasis should be on just "really", I'd say:

No port really needs to be root.
No port really needs to be root.

42

What does "fake those calls" mean? If it is described elsewhere, a link on those three words would help.

The second sentence needs a pause after the second time. But it's better to have sentences that don't make the reader pause:
Slight patching of the port's Makefile is needed in some cases.

This should be followed by a sentence that tells what kind of patching would be done.

"For example, calls to blahblah can be patched to use zzyx."

57

End the sentence here, and the next line starts a new one.

s%</link>%</link>.%

58

s/it/It/

Serial comma needed: s/build/build,/

mat marked 6 inline comments as done.Jun 30 2015, 1:16 PM
mat added inline comments.
en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
42

Mmm, it means, that if you run, say, chown bin foobar, it will mock up the chown call so that it returns "all ok" but without doing them for real, and failing because it's not running as root, say:

[mat@aragorn /usr/home/mat]$ id
uid=1000(mat) gid=1000(mat) groups=1000(mat),0(wheel),1010(poudriere)
[mat@aragorn /usr/home/mat]$ fakeroot
[mat@aragorn /usr/home/mat]$ id
uid=0(root) gid=0(wheel) groups=1000(mat),0(wheel),1010(poudriere)
[mat@aragorn /usr/home/mat]$ touch foobar
[mat@aragorn /usr/home/mat]$ ls -l foobar
-rw-r--r--  1 root  wheel  0 30 jui 15:06 foobar
[mat@aragorn /usr/home/mat]$ chown bin foobar
[mat@aragorn /usr/home/mat]$ ls -l foobar
-rw-r--r--  1 bin  wheel  0 30 jui 15:06 foobar
[mat@aragorn /usr/home/mat]$ exit
exit
[mat@aragorn /usr/home/mat]$ ls -l foobar
-rw-r--r--  1 mat  wheel  0 30 jui 15:06 foobar
[mat@aragorn /usr/home/mat]$ exit

It's a tool created by Debian to help building packages as a regular user, it just fakes being root, like its name suggests :-)

It's a bit hard to give example of the kind of patching that will need to be done, because most of it should be faked by USES=fakeroot, so, it's kinda left to the porter to figure out what is wrong with the software he is trying to make work.

mat marked an inline comment as done.

Update.

en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
42

In that case, we should tell the reader where they can find information on how this works. Maybe

See <link href="https://wiki.debian.org/FakeRoot"/> for more information on the <command>fakeroot</command> tool.

mat marked 2 inline comments as done.Jul 2 2015, 11:57 AM
mat added inline comments.
en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
42

Mmmm, ok, though, I'll use http://fakeroot.alioth.debian.org/ which seems to be the project's homepage. And maybe add that on the USES page and not here.

mat marked an inline comment as done.

Add a bit about where to find more information on fakeroot.

en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
42

Nice!

wblock edited edge metadata.

Please remember to build-test before commit. Thanks!

This revision is now accepted and ready to land.Jul 5 2015, 1:20 AM
This revision was automatically updated to reflect the committed changes.