Chameleon > General Discussion

Documentation for Chameleon 2.0 RC

<< < (2/4) > >>


--- Quote from: rocksteady on September 16, 2009, 01:07:22 PM ---Please rename your file to Using Chameleon 2RC.

More feedback when I go through your doc again.
--- End quote ---

Done. I'll also cover some areas of concern myself:

• I thought that something about sourcecode was important and should be right at the top, but striking the right -> tone <- was difficult.

• The particulars of how Chameleon works & the boot* files may be wildly off

• I wanted to list where the Extra folder could go, but it looks like I may have confused the issue even more. I wanted "/Extra" to denote the root and "Extra" to just be any path, but I think for a new user, this could confuse the issue. The listing of the Extra/Extensions folder makes it look like a mess, but I wanted to cover all the bases (new & veteran users). Maybe a picture...

• somewhere it says to use the included fdisk. I don't think I used that fdisk for 10.6. This doc uses the stock OS fdisk in $PATH.

• for RAID, OrigDoc edit the /Library/Preferences/SysConfig/, but this doc does it differently. My thinking was that since there will have to be an Extra folder somewhere, it should be in that Extra folder. Unfortunately, I put it onto the hidden partition which makes it more cumbersome. I think the RAID instructions should change to a root-based /Extra folder & skip the the multiple Extra folders on the hidden partition. This preserves a fresh (admittedly a simple file, but when you wreck it & don't know, that doesn't help) with a single Extra folder.
• In the EFI partition formatting, I changed the unmount to sudo unmount. You need admin privs to do that which the "exit" releases earlier in the process. I didn't want users making folders & copying .kexts that they couldn't get at in the Finder or easily edit a .plist in TextEdit.

Very nice.  Maybe we should label this, the Missing Manual...

Might have reduced a lot of my headaches and saved me about 57 reboots had this been available a week ago. HA!  but what fun would that have been....

Good job.



I've spent some time with your guide now (well a few hours at least.) its a very nice piece of work. If I could be so bold as to offer some suggestions...

1) RTF is nice as its universally readable by everyone, including those guys in '-s'. but you may want to shift it to PDF just so it locks things in place.  It might make it look more readable. 

2) I think the layout is very usable, recommend adding a Table of Contents just so you can see what is where in the document.

3) I think you *should* include source code analysis (perhaps create an advanced section to talk about it.)

4) Recommend adding a version/changelog discussion at some point.

5) I love the string examples.  I love code examples and find them very useful.  If you went PDF, you could add screenshots, the other think I think adds a lot to understanding.

6) For the n00bs (self included) recommend including a discussion of what files get hidden from finder and how to re-enable visibility.

Feel free to take any/some/all/none of these suggestions.  They're just my opinion and we all know about opinions...


Thankyou for this excellent piece of documentation, helped me no end!

One small point, in the section "Installing Chameleon into a hidden EFI partition on a hard drive (non-RAID):" you omit to put a step in to put 'boot' into the root folder of the EFI partition. This caught me, and took quite a long time for me to work out what I'd done wrong.

All best


Lord Anubis:

--- Quote from: diabolist on October 30, 2009, 01:23:31 AM ---you omit to put a step in to put 'boot' into the root folder of the EFI partition.

--- End quote ---

there should be no OS on the EFI partition, therefor 'boot' should be not on the EFI partition. 'boot' should be in the root folder of the partition where your OS lives. That/your step is not right and shouldn't be done.

Check your setup carefully for errors.




[0] Message Index

[#] Next page

[*] Previous page

Go to full version