Core book RC1

[curaga]

http://tinycorelinux.net/~curaga/corebook.pdf

The Core book is now at RC. Should no big changes arise, the print version will be available a few weeks after 1.0.

Now's your chance to get your name (or nick if you prefer) in print: find a bug (typo, bad sentence, etc), win eternal glory!

[Juanito]

impressive 

[curaga]

You didn't check it out before this?

[coreplayer2]

Great job, and a great reference tool.

I like the idea of defining terms or concepts in chapters which use them, like many chapters in this book for example "4.1 tce-load"

I think loaded, mounted and installed have similar meanings.  Where this pertains to extensions they might need defining somewhere.

Alternatively or additionally expanding on those definitions in chapters where those terms are used eg;

10.30. desktop - specify window manager
If only one window manager is loaded, that one will be used. If you have multiple window managers installed, this bootcode will let you specify which one to load.
Example:
• desktop=fluxbox

Which is cleverly written and there is no confusion if you understand the authors meaning of installed and loaded.  However if the reader is not aware of the distinctions between them it might result in some confusion especially coming from windows.

One possible suggestion:

10.30. desktop - specify window manager
If only one window manager is loaded from either onboot.lst or tce-load, that one will be used. If you have multiple window managers installed to your tce directory, this bootcode will let you specify which one to load.
Example:
• desktop=fluxbox



Just my observation


Also might be beneficial to include an example of the waitusb=15:UUID=abcdefghetcetc  along with the LABEL example

[coreplayer2]

Is the information you have regarding Virtualbox  correct? 

I find Virtualbox v4.x indispensable for creating core remasters, trial runs, creating extensions, and for temporary loading of tinycoreplus where you do not have a cd drive for installing core to a USB stick.

The deal with the mouse is "enable absolute pointing device" is enabled by default during installations even on PC's that are not tablets.  All that is necessary to switch between host and guest is the Ctrl key after disabling " absolute pointing device " 

Virtualbox works like a charm




just an FYI

[Rich]

Hi curaga
I just finished proofreading Core book and in my opinion it's very well written. Attached is a list of suggested
changes in wording, spelling, and punctuation for you to use or ignore as you see fit. The page numbers in the
attached file refer to the numbers reported by the PDF reader, not the numbers on the pages themselves.
Hope this helps.

[curaga]

Thanks coreplayer2, fixed those up. I added the terminology to the intro chapter, and updated the UUID examples and VBox info.

Rich, I really appreciate your help, this must be the Nth time for you to read the same pages. In particular I seemed to miss some repetition like "it pauses it pauses", I really need to script a check for those

Most of your changes added. In one of the "for vs of" cases I think it's a matter of style. Regarding the

USB devices'

possessive plural, I believe it's correct:
http://english.stackexchange.com/questions/1073/what-is-the-correct-possessive-for-nouns-ending-in-s

[Rich]

Hi curaga

In one of the "for vs of" cases I think it's a matter of style.

I'm not sure which one you are referring to:

Code: [Select]

Page 11
From:
with no fear for the command line.
To:
with no fear of the command line.The first suggests you are not afraid for the command line (i.e. its health or well being). The second says you
need not be afraid to use it.

or:

Code: [Select]

Page 53
From:
This option allows you to do a corruption check for downloaded
extensions.
To:
This option allows you to do a corruption check of downloaded
extensions.If you want to use for, this makes more sense:

Code: [Select]

This option allows you to do a corruption check for downloading
errors
The a vs. an cases could be considered a matter of style depending on pronunciation:

Code: [Select]

Page 119
From:
a SSH server giving secure read-write access.
To:
an SSH server giving secure read-write access.

Page 125
From:
launches a RDP session to a pre-determined target.
To:
launches an RDP session to a pre-determined target.a "secure shell" server  vs.  an "ess-ess-aych" server
A "remote desktop protocol" session  vs.  an "are-dee-pee" session

possessive plural, I believe it's correct:

I take it you are referring to this one:

Code: [Select]

1.4. USB and other external storage
devices' special requirementsThat could go either way I suppose. I read it as "in addition to USB" (plural) as opposed to special requirement
for "a" device (possessive).

[coreplayer2]

1.4. USB and other external storage
devices' special requirements

That's an interesting one..

I'm not sure if I remember correctly anymore but AFAIK an apostrophe may be used when associating possession but never in plural.  If not singular make compounded nouns plural, then apply possession.  Do what I do, when in doubt better to avoid the critique and rewrite the sentence. 

If it fits I suggest:

Code: [Select]

1.4. Special requirements of USB and
other external storage devices
 

[coreplayer2]

Speaking of Chapter 1.4     I noticed 'Sometimes' makes 'though' redundant.   Otherwise that's a great explanation of a "tce" drive not online in time.

Sometimes, hardware doesn’t wake up fast enough for Tiny Core’s
boot sequence, though. If the hardware doesn’t wake up in time,
Tiny Core will move on and finish booting without that data

just helping..   

[curaga]

@Rich

I meant the fear sentence, yes. You're right there, changed.

@Both

Shortened it to just "USB and other external storage devices", even if it was correct, seems it was too ambiguous.

Speaking of Chapter 1.4     I noticed 'Sometimes' makes 'though' redundant.   Otherwise that's a great explanation of a "tce" drive not online in time.

Fixed, thanks.


The PDF has been updated.

[Juanito]

Ref: "The partition should be formatted with a Linux file system. We recommend ext4." - should we add that a non-journalling solution would be better for usb sticks and similar?

Ref: "Download core.gz and vmlinuz from your closest mirror, from the directory release/distribution_files. The link for the main mirror is http://repo.tinycorelinux.net/4.x/x86/release/distribution_files/." - should we update this for 5.x and rootfs/modules?

[curaga]

The book is for the latest 4.x on purpose, that's covered in the first pages. Adding a mention on the journaling.