-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Hi. The content expected for the Users'' Manual is not yet finished. However, I''ve reorganized the Users'' Manual in anticipation of new content and rewrites coming soon. I''d like to get this into the xen-unstable tree. Please pull from xen-unstable-docs. Signed-off-by: Robb Romans <FMJ@us.ibm.com> Signed-off-by: Nivedita Singhvi <niv@us.ibm.com> ****************************************** # HG changeset patch # User Robb Romans <FMJ@us.ibm.com> # Node ID a3aed1b8221cc8c85d3cd43167ea7dfdf4121865 # Parent 378e1c58bcd20a1622977796af39dcf8030e1588 Reorg patch 1 to match http://wiki.xensource.com/xenwiki/Xen3DocsToDo First patch to reorganize the manual to match the structure in the Xen3DocsToDo Wiki entry. Incorporates a patch from Nivedita Singhvi to clean up the Further Support Chapter. ****************************************** # HG changeset patch # User Robb Romans <FMJ@us.ibm.com> # Node ID 1ccc9cc0c8e7974dd223d408c2104664868f9424 # Parent 59d34450bea9386c184f7444a43b75a4548ba05f Reorg patch 2 to match http://wiki.xensource.com/xenwiki/Xen3DocsToDo Second patch to reorganize the manual to match the structure in the Xen3DocsToDo Wiki entry. ******************************************* # HG changeset patch # User Robb Romans <FMJ@us.ibm.com> # Node ID 4f1811450b4e2e3827856650941456ab5f568821 # Parent 1ccc9cc0c8e7974dd223d408c2104664868f9424 Small cleanup for distro chapters. ******************************************* diffstat: a/docs/src/user/build.tex | 170 ------------------------ a/docs/src/user/redhat.tex | 61 -------- b/docs/src/user/booting_xen.tex | 3 b/docs/src/user/building_xen.tex | 3 b/docs/src/user/console_management.tex | 3 b/docs/src/user/cpu_management.tex | 3 b/docs/src/user/debugging.tex | 25 +++ b/docs/src/user/dom0_installation.tex | 3 b/docs/src/user/domU_installation.tex | 3 b/docs/src/user/fedora.tex | 61 ++++++++ b/docs/src/user/further_support.tex | 52 +++++++ b/docs/src/user/gentoo.tex | 3 b/docs/src/user/known_problems.tex | 3 b/docs/src/user/logfiles.tex | 3 b/docs/src/user/memory_management.tex | 51 +++++++ b/docs/src/user/migrating_domains.tex | 70 ++++++++++ b/docs/src/user/monitoring_xen.tex | 3 b/docs/src/user/network_management.tex | 3 b/docs/src/user/options.tex | 149 +++++++++++++++++++++ b/docs/src/user/rhel.tex | 3 b/docs/src/user/scheduler_management.tex | 3 b/docs/src/user/suse.tex | 3 b/docs/src/user/testing.tex | 3 b/docs/src/user/xenstat.tex | 3 b/docs/src/user/xentrace.tex | 3 docs/src/user.tex | 199 +++++++++++++++------------- docs/src/user/control_software.tex | 95 ------------- docs/src/user/debian.tex | 94 +++++++------ docs/src/user/debugging.tex | 9 - docs/src/user/domain_filesystem.tex | 2 docs/src/user/domain_mgmt.tex | 214 ++++++++++++------------------- docs/src/user/fedora.tex | 95 +++++++------ docs/src/user/installation.tex | 194 +++++++++++++--------------- docs/src/user/introduction.tex | 127 ++++++++---------- 34 files changed, 915 insertions(+), 804 deletions(-) Regards, Robb - -- Robb Romans (512) 838-0419 Linux Commando T/L 678-0419 ARS NA5TT .-- - ..-. ..--.. -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.1 (GNU/Linux) Comment: Processed by Mailcrypt 3.5.8 <http://mailcrypt.sourceforge.net/> iD8DBQFDg5B+doW/RCLrCx0RAmMbAJ9/4Ss0Ei8cMLWZhc4c01AFkPHIvACePYwH o1wUEoV9gsDAaFwKOMV+OWE=7U7J -----END PGP SIGNATURE----- _______________________________________________ Xen-devel mailing list Xen-devel@lists.xensource.com http://lists.xensource.com/xen-devel
On 22 Nov 2005, at 21:41, Robb Romans wrote:> Hi. The content expected for the Users'' Manual is not yet > finished. However, I''ve reorganized the Users'' Manual in anticipation > of > new content and rewrites coming soon. I''d like to get this into the > xen-unstable tree. > > Please pull from xen-unstable-docs. > > Signed-off-by: Robb Romans <FMJ@us.ibm.com> > Signed-off-by: Nivedita Singhvi <niv@us.ibm.com>Is it helpful to break the docs up into loads of tiny little files? -- Keir _______________________________________________ Xen-devel mailing list Xen-devel@lists.xensource.com http://lists.xensource.com/xen-devel
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1>>>>> "KF" == Keir Fraser <Keir.Fraser@cl.cam.ac.uk> writes:KF> Is it helpful to break the docs up into loads of tiny little KF> files? The "tiny little files" are chapters, where I am expecting the various authors to supply content. This was discussed and agreed upon long ago (that the manuals would be broken up into chapter files). You''ll notice that they are in a separate directory, in order to not clutter up the docs/src directory. Regards, Robb - -- Robb Romans (512) 838-0419 Linux Commando T/L 678-0419 ARS NA5TT .-- - ..-. ..--.. -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.1 (GNU/Linux) Comment: Processed by Mailcrypt 3.5.8 <http://mailcrypt.sourceforge.net/> iD8DBQFDhK8ZdoW/RCLrCx0RAvZyAKCGXEy28dDO2Q6D+dy/XKEf8bTUWACfYsBN xWlGIJM8UrMhcjprDEhchLs=bEri -----END PGP SIGNATURE----- _______________________________________________ Xen-devel mailing list Xen-devel@lists.xensource.com http://lists.xensource.com/xen-devel
I''m not sure the granularity of splitting things up necessarily *needs* to be quite so small but having looked through a couple of the changesets I''ve got no major objections. If it makes it easier for the folks working on documentation (any comments from those guys???) then I think we should merge it. Btw, Robb, I thought saw a section on Xenstored in there - do you have a plan for what''s going to go into there? We don''t really want the users to know xenstored is there, it should be handled by Xend automatically. Ideally we wouldn''t need to document it. Cheers, Mark On Nov 23 2005, Robb Romans wrote:>-----BEGIN PGP SIGNED MESSAGE----- >Hash: SHA1 > >>>>>> "KF" == Keir Fraser <Keir.Fraser@cl.cam.ac.uk> writes: > > KF> Is it helpful to break the docs up into loads of tiny little > KF> files? > >The "tiny little files" are chapters, where I am expecting the various >authors to supply content. This was discussed and agreed upon long ago >(that the manuals would be broken up into chapter files). You''ll notice >that they are in a separate directory, in order to not clutter up the >docs/src directory. > >Regards, >Robb > > >- -- >Robb Romans (512) 838-0419 >Linux Commando T/L 678-0419 >ARS NA5TT >.-- - ..-. ..--.. >-----BEGIN PGP SIGNATURE----- >Version: GnuPG v1.4.1 (GNU/Linux) >Comment: Processed by Mailcrypt 3.5.8 <http://mailcrypt.sourceforge.net/> > >iD8DBQFDhK8ZdoW/RCLrCx0RAvZyAKCGXEy28dDO2Q6D+dy/XKEf8bTUWACfYsBN >xWlGIJM8UrMhcjprDEhchLs>=bEri >-----END PGP SIGNATURE----- > >_______________________________________________ >Xen-devel mailing list >Xen-devel@lists.xensource.com >http://lists.xensource.com/xen-devel >_______________________________________________ Xen-devel mailing list Xen-devel@lists.xensource.com http://lists.xensource.com/xen-devel
>I''m not sure the granularity of splitting things up >necessarily *needs* to be quite so small but having >looked through a couple of the changesets I''ve got >no major objections.>If it makes it easier for the folks working on >documentation (any comments from those guys???) >then I think we should merge it.It makes it easier to divvy up the work... Alan C. Oehler Sr. Technical Writer XenSource, Inc. Phone: 650.798.5900 x 240 _______________________________________________ Xen-devel mailing list Xen-devel@lists.xensource.com http://lists.xensource.com/xen-devel
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1>>>>> "MAW" == M A Williamson <maw48@cam.ac.uk> writes:MAW> Btw, Robb, I thought saw a section on Xenstored in there - do MAW> you have a plan for what''s going to go into there? We don''t MAW> really want the users to know xenstored is there, it should be MAW> handled by Xend automatically. Ideally we wouldn''t need to MAW> document it. It''s in the outline referenced at: http://wiki.xensource.com/xenwiki/Xen3DocsToDo I have no objections to removing it, or moving that section to the Interface Manual. I''ve had it in the back of my mind to rename the Interface Manual to the Developers'' Manual. Gentoo has the concept of a document mostly for users, and a document mostly for developers. Thoughts? Regards, Robb - -- Robb Romans (512) 838-0419 Linux Commando T/L 678-0419 ARS NA5TT .-- - ..-. ..--.. -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.1 (GNU/Linux) Comment: Processed by Mailcrypt 3.5.8 <http://mailcrypt.sourceforge.net/> iD8DBQFDhNg6doW/RCLrCx0RAr4eAJ9A62ndy1VU3S8uIBkLWyPxYkmbeQCfVs3K joCN8w/4TUwXxUjsvyvYwIs=qx1+ -----END PGP SIGNATURE----- _______________________________________________ Xen-devel mailing list Xen-devel@lists.xensource.com http://lists.xensource.com/xen-devel
>It''s in the outline referenced at: >http://wiki.xensource.com/xenwiki/Xen3DocsToDo > >I have no objections to removing it, or moving that section to the >Interface Manual.Well, it''s harmless for now. We may find it unnecessary though... There are a couple of options for xenstored but they shouldn''t really be interesting to normal users.>I''ve had it in the back of my mind to rename the Interface Manual to the >Developers'' Manual. Gentoo has the concept of a document mostly for >users, and a document mostly for developers. Thoughts?I''m currently reworking the Interface Manual to *really* document the Xen hypercall / shared memory interface in a relatively thorough manner. At some point in the future (post release, I think!) we might like to consider an developers manual that describes internals, debugging tools, implementation details, etc. This could either be rolled into the interface manual, or be a separate part in the same document. Cheers, Mark>Regards, >Robb > > >- -- >Robb Romans (512) 838-0419 >Linux Commando T/L 678-0419 >ARS NA5TT >.-- - ..-. ..--.. >-----BEGIN PGP SIGNATURE----- >Version: GnuPG v1.4.1 (GNU/Linux) >Comment: Processed by Mailcrypt 3.5.8 <http://mailcrypt.sourceforge.net/> > >iD8DBQFDhNg6doW/RCLrCx0RAr4eAJ9A62ndy1VU3S8uIBkLWyPxYkmbeQCfVs3K >joCN8w/4TUwXxUjsvyvYwIs>=qx1+ >-----END PGP SIGNATURE----- >_______________________________________________ Xen-devel mailing list Xen-devel@lists.xensource.com http://lists.xensource.com/xen-devel