Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 42712 - distcc guide: reorganization needed
Summary: distcc guide: reorganization needed
Status: RESOLVED FIXED
Alias: None
Product: [OLD] Docs-user
Classification: Unclassified
Component: Other (show other bugs)
Hardware: All Linux
: High minor (vote)
Assignee: Jonathan Smith (RETIRED)
URL:
Whiteboard:
Keywords:
: 96007 (view as bug list)
Depends on:
Blocks: 94444
  Show dependency tree
 
Reported: 2004-02-24 00:03 UTC by Owen Gunden
Modified: 2005-07-01 21:07 UTC (History)
5 users (show)

See Also:
Package list:
Runtime testing required: ---


Attachments
distcc.xml.diff (distcc.xml.diff,14.77 KB, patch)
2005-05-22 07:35 UTC, Jonathan Smith (RETIRED)
Details | Diff
distcc-modded.xml (distcc-modded.xml,12.91 KB, text/plain)
2005-05-22 07:36 UTC, Jonathan Smith (RETIRED)
Details
Lisa's attempt (distcc.xml,12.16 KB, text/plain)
2005-06-15 04:41 UTC, Lisa Seelye (RETIRED)
Details
ready to try again. (distcc.xml,12.16 KB, text/plain)
2005-06-23 08:26 UTC, Lisa Seelye (RETIRED)
Details
If THIS doesn't work I'm going to copy it to disk and snail mail it! (distcc.xml.diff,6.48 KB, patch)
2005-06-27 02:35 UTC, Lisa Seelye (RETIRED)
Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Owen Gunden 2004-02-24 00:03:58 UTC
It's really not clear which parts of the distcc guide pertain to the machine that's being set up to use distcc as its compiler and which parts pertain to the machines that are lending cpu power.  For example, immediately after code listing 2.6 (which presumably is for the machine which will use distcc as its compiler), it says "don't forget to start the distcc daemon" -- but which machine(s) should be running this daemon?

A good idea would be to separate the whole thing into two sections: one for distcc crunchers and one for distcc clients.  Of course they both use the same ebuild currently (though there's been some discussion on gentoo-dev about separating these out with client/server USE flags), but making it clear which parts of the configuration are necessary for which ends of distcc would help a lot.

Reproducible: Always
Steps to Reproduce:
Comment 1 Lisa Seelye (RETIRED) gentoo-dev 2004-02-26 10:22:18 UTC
If someone on the docs team wants to restyle the distcc docs be my guest. However I'd like to read a new version before it's comitted.

Thanks.
Comment 2 Sven Vermeulen (RETIRED) gentoo-dev 2004-04-11 07:02:41 UTC
This has been lurking for too long now without extra input. Marking as LATER.
Comment 3 Jonathan Smith (RETIRED) gentoo-dev 2005-05-22 06:59:33 UTC
the problem here is that the "host" and "client" are basically the same. distcc
is a network which can allow for multiple hosts and clients. also, a client can
become a host at any moment...

however, it does need some tweaking. i'm working on it now
Comment 4 Jonathan Smith (RETIRED) gentoo-dev 2005-05-22 07:35:32 UTC
Created attachment 59541 [details, diff]
distcc.xml.diff

the patched version is available for viewing in a browser from
http://neverland.ncssm.edu/~smithj/gentoo/distcc-modded.html

all i really did was clean it up, make it clearer in a number of sections,
reorganize, and add a few warnings. it should, however, clear up the
host/client issue
Comment 5 Jonathan Smith (RETIRED) gentoo-dev 2005-05-22 07:36:48 UTC
Created attachment 59542 [details]
distcc-modded.xml

the entire xml source, as lisa requested on irc
Comment 6 Lisa Seelye (RETIRED) gentoo-dev 2005-05-22 07:41:01 UTC
I'll read this over and see if it's suitable from a distcc standpoint.
Comment 7 Jan Kundrát (RETIRED) gentoo-dev 2005-06-13 13:47:16 UTC
*** Bug 96007 has been marked as a duplicate of this bug. ***
Comment 8 Jonathan Smith (RETIRED) gentoo-dev 2005-06-14 15:25:51 UTC
(In reply to comment #6)
> I'll read this over and see if it's suitable from a distcc standpoint.

any word?
Comment 9 Lisa Seelye (RETIRED) gentoo-dev 2005-06-15 03:46:35 UTC
The diff failed to apply on the CVS co a few minutes ago, so I'm reviewing it 
now.

I'm not 100% pleased with the reordering and parts of it are factually 
inacurate.
Comment 10 Lisa Seelye (RETIRED) gentoo-dev 2005-06-15 04:41:49 UTC
Created attachment 61267 [details]
Lisa's attempt

This version is rewritten a bit and different from the previous attachments but
has a bit of it.  Probably needs to credit Jonathan Smith with reviewer.
Comment 11 Jonathan Smith (RETIRED) gentoo-dev 2005-06-15 06:52:20 UTC
(In reply to comment #10)
> Probably needs to credit Jonathan Smith with reviewer.

i don't care; i just want better docs :-)
Comment 12 Xavier Neys (RETIRED) gentoo-dev 2005-06-15 07:06:11 UTC
(In reply to comment #10)
> Created an attachment (id=61267) [edit]
> Lisa's attempt

Your file is the same as the one already online.
Looks like you uploaded the original.
Comment 13 Lisa Seelye (RETIRED) gentoo-dev 2005-06-15 07:43:01 UTC
Argh, crap!!

I'll have to do this again..
Comment 14 Jonathan Smith (RETIRED) gentoo-dev 2005-06-20 17:54:17 UTC
lisa: any word?
Comment 15 Lisa Seelye (RETIRED) gentoo-dev 2005-06-23 08:26:09 UTC
Created attachment 61784 [details]
ready to try again.

Please read and let me know how this addresses outstanding issues.
Comment 16 Jonathan Smith (RETIRED) gentoo-dev 2005-06-25 10:46:02 UTC
(In reply to comment #15)
> ready to try again.
> 
> Please read and let me know how this addresses outstanding issues.

lisa: i'm not sure how you did it, but you posted an unchanged file again, right
down to the cvs header

a diff would be nice :-)
Comment 17 Lisa Seelye (RETIRED) gentoo-dev 2005-06-27 02:35:24 UTC
Created attachment 62037 [details, diff]
If THIS doesn't work I'm going to copy it to disk and snail mail it!
Comment 18 Jonathan Smith (RETIRED) gentoo-dev 2005-07-01 15:20:06 UTC
lisa: you silly goose, you forgot date bump
Comment 19 Lisa Seelye (RETIRED) gentoo-dev 2005-07-01 15:37:36 UTC
Pfft.

I think the docs team is capable of entering the correct date. ;)
Comment 20 Jonathan Smith (RETIRED) gentoo-dev 2005-07-01 15:42:54 UTC
lisa: you missed a few things, including proper line-breaks, but i fixed them

fixed
Comment 21 Shyam Mani (RETIRED) gentoo-dev 2005-07-01 20:59:04 UTC
(In reply to comment #18)
> lisa: you silly goose, you forgot date bump

Bah. That's your thingy ;) The person who commits should check date + version.

Comment 22 Jonathan Smith (RETIRED) gentoo-dev 2005-07-01 21:07:15 UTC
fox2mike: no responding to already-closed bugs... it makes me think i have to
actually _do_ something :-P