From 3af86cea7c428f0f59e4cc639a3455812af2a702 Mon Sep 17 00:00:00 2001 From: JF Ding Date: Wed, 8 Feb 2012 09:12:15 +0800 Subject: [PATCH] new doc KNOWN-ISSUES to highlight syslinux issue and update README.rst with new section too --- KNOWN-ISSUES | 11 +++++++++++ README.rst | 28 ++++++++++++++++++++++------ 2 files changed, 33 insertions(+), 6 deletions(-) create mode 100644 KNOWN-ISSUES diff --git a/KNOWN-ISSUES b/KNOWN-ISSUES new file mode 100644 index 0000000..1f58731 --- /dev/null +++ b/KNOWN-ISSUES @@ -0,0 +1,11 @@ +Known Issues +============ + +Bug of latest "syslinux" package +-------------------------------- +In some new Linux distributions, the "syslinux" package in their official +software repositories is the version 4.04. It will cause segment fault for +a fatal bug, and mic will failed with syslinux installation errors. + +The solution is to install the patched "syslinux" package in MeeGo or Tizen's +tools repos, until the official released one being fixed. diff --git a/README.rst b/README.rst index 0938e29..4bdab22 100644 --- a/README.rst +++ b/README.rst @@ -109,7 +109,8 @@ Ubuntu/Debian Installation > deb http://download.meego.com/live/devel:/tools:/building/_/ / > REPO -*Tips*: for Ubuntu 10.10, you should use xUbuntu_10.10 to replace _. +*Tips*: for Ubuntu 10.10, you need to use xUbuntu_10.10 to replace +_. 2. Update repolist: :: @@ -243,7 +244,9 @@ or :: $ sudo mic cr fs test.ks --outdir output -*Tips*: if you failed to create armv7* image, the reason may be qemu/qemu-arm on your host is lower than required, please update qemu/qemu-arm higher than 0.13.0. +*Tips*: if you failed to create armv7* image, the reason may be: qemu/qemu-arm +on your host is lower than required, please upgrade qemu/qemu-arm higher than +version 0.13.0. Running 'mic chroot' -------------------- @@ -287,10 +290,23 @@ of ks file, example as follows: :: Multiple running instances support ---------------------------------- -mic support running multi-instance, but cache dir can't be shared between instances, -so you should specify different cachedir for different instance using `--cachedir`. -Also outdir should be specified to a different directory for each instance using -`--outdir`, example as follows: :: +mic support running multi-instance, but cache dir can't be shared between +instances, so you should specify different cachedir for different instance +using `--cachedir`. Also outdir should be specified to a different directory +for each instance using `--outdir`, example as follows: :: mic cr fs netbook1.ks --cachedir=/var/tmp/cache/mic1 --outdir=out1 mic cr fs netbook2.ks --cachedir=/var/tmp/cache/mic2 --outdir=out2 + +Known Issues +============ + +Bug of latest "syslinux" package +-------------------------------- +In some new Linux distributions, the "syslinux" package in their official +software repositories is the version 4.04. It will cause segment fault for +a fatal bug, and mic will failed with syslinux installation errors. + +The solution is to install the patched "syslinux" package in MeeGo or Tizen's +tools repos, until the official released one being fixed. + -- 2.7.4