CRUX

Welcome to CRUX bug tracking.
Tasklist

FS#1201 - Minor Handbook Changes To Introduce Package System

Attached to Project: CRUX
Opened by David L. Craig (dlc) - Thursday, 18 June 2015, 22:22 GMT
Last edited by Predrag Ivanovic (pedja) - Wednesday, 21 November 2018, 15:50 GMT
Task Type Improvement
Category doc
Status Assigned
Assigned To CRUX Developers (crux)
Fredrik Rinnestam (frinnst)
Operating System CRUX
Severity Low
Priority Normal
Reported Version 3.1
Due in Version Undecided
Due Date Undecided
Percent Complete 0%
Votes 2
Private No

Details

As a CRUX newbie, I was challenged to grok the package system from the Handbook. I offer the attached small ed file to clarify (1) the expected skills to work with CRUX, and (2) clarification of what packages are and how the package system maps into the standard recipe for installing tarballs.
   Handbook3-1.htm.ed (2.7 KiB)
This task depends upon

Comment by David L. Craig (dlc) - Friday, 19 June 2015, 12:17 GMT
I added one and a half sentences to that first paragraph to introduce patch files and the definition of a port.
   Handbook3-1.htm.ed (2.8 KiB)
Comment by David L. Craig (dlc) - Friday, 19 June 2015, 12:42 GMT
I broke out the package components into an ordered list and some miscellaneous readability changes. Obviously I vote for this version. :-)
   Handbook3-1.htm.ed (2.9 KiB)
Comment by David L. Craig (dlc) - Friday, 19 June 2015, 12:46 GMT
Hmmm... in case the ed script is too opaque, here's a diff -C 1 listing of the previous ed listing.
   Handbook3-1.htm.C1 (4.9 KiB)
Comment by David L. Craig (dlc) - Friday, 19 June 2015, 13:04 GMT
Hopefully renaming that to ...C1.txt will open in your browser more readably.
   Handbook3-1.htm.C1.txt (4.9 KiB)
Comment by David L. Craig (dlc) - Monday, 22 June 2015, 22:03 GMT
Here is an expansion: a new paragraph/subsection to segue from the Package System to the Ports System, and another at the end of the Ports section to discuss private collections.
   Handbook3-1.htm.C1.log (9.9 KiB)
   Handbook3-1.htm.ed (7 KiB)
Comment by Fredrik Rinnestam (frinnst) - Tuesday, 23 June 2015, 14:40 GMT
Thanks for your work!
However, I must say I don't really agree with the tone of some of the changes.

Will look it over in more detail for 3.2.
Comment by David L. Craig (dlc) - Tuesday, 23 June 2015, 17:34 GMT
I was seeking the middle ground for that tone based on everything I've read so far regarding entry level skill sets for CRUX newbies and getting support. There is a bit of range in that sample, I hope you would agree. I would love to see a project consensus on style but I doubt that has a sufficiently high priority for folks to hammer that out. I hope you do not consider anything I wrote to be rude!
Comment by Tim Biermann (tb) - Friday, 23 August 2019, 14:52 GMT
Personally, i would say from what i read in Handbook3-1.htm.C1.txt, it is a bit too harsh for my desire. But in general it's a nice idea to make the handbook more useful for newcomers.

I would disagree with "the upstream source tarball untouched by CRUX" as it certainly can happen, right?

Loading...