catalyst-spec.5.txt: Clarify "within the loop" (squashfs) rewrite
authorW. Trevor King <wking@tremily.us>
Tue, 5 Mar 2013 00:43:33 +0000 (19:43 -0500)
committerW. Trevor King <wking@tremily.us>
Tue, 4 Jun 2013 17:45:48 +0000 (13:45 -0400)
commit4130fa845e8dca1e609a4050443af96e8671c313
tree42b41bd03909d0ee2acfd4bc75652177fd4dae3e
parente380edd6a7c6ce69c6ea2e86e8ab11b40dd88f46
catalyst-spec.5.txt: Clarify "within the loop" (squashfs)

When you build a livecd-stage2, you get an ISO, inside of which is
something like:

  # mount -o loop livecd.iso iso
  # tree iso
  iso/
  |-- # stuff from livecd/overlay
  |-- image.squashfs  # the compressed root filesystem
  |-- isolinux
  |   |-- # kernel
  |   |-- # and
  |   `-- # related help
  |-- livecd          # empty, probably just a marker
  `-- README.txt      # help for kernel command line options

Inside the image.squashfs (or image.*, as configured by
livecd/fstype) is the root filesystem:

  # mount -o loop iso/image.squashfs squashfs
  # ls squashfs
  bin   dev  home  media  opt   root  sbin  tmp  var
  boot  etc  lib   mnt    proc  run   sys   usr

So if you want to tweak the root filesystem, use livecd/root_overlay.
If you want to tweak the ISO filesystem, use livecd/overlay.

Signed-off-by: W. Trevor King <wking@tremily.us>
doc/catalyst-spec.5.txt