diff options
author | Richard W.M. Jones <rjones@redhat.com> | 2012-07-17 12:46:04 +0100 |
---|---|---|
committer | Richard W.M. Jones <rjones@redhat.com> | 2012-07-17 13:18:39 +0100 |
commit | 4bc110e2bc738bde9b9c09bc602ef13c06b60e90 (patch) | |
tree | 7f810c045350b87c8acdebae14cd38fedcdb5a27 | |
parent | 182b4a66609ffd5366575d72351cd8174cf68145 (diff) | |
download | libguestfs-4bc110e2bc738bde9b9c09bc602ef13c06b60e90.tar.gz libguestfs-4bc110e2bc738bde9b9c09bc602ef13c06b60e90.tar.xz libguestfs-4bc110e2bc738bde9b9c09bc602ef13c06b60e90.zip |
docs: Use L<...> for links.
Instead of working around bugs, podwrapper has been fixed so that
links work in all output formats.
-rw-r--r-- | edit/virt-edit.pod | 2 | ||||
-rw-r--r-- | examples/guestfs-faq.pod | 2 | ||||
-rw-r--r-- | examples/guestfs-recipes.pod | 46 | ||||
-rw-r--r-- | examples/guestfs-testing.pod | 6 | ||||
-rw-r--r-- | src/guestfs.pod | 2 |
5 files changed, 27 insertions, 31 deletions
diff --git a/edit/virt-edit.pod b/edit/virt-edit.pod index 765b8b27..119deeea 100644 --- a/edit/virt-edit.pod +++ b/edit/virt-edit.pod @@ -338,7 +338,7 @@ This issue was assigned CVE-2012-2690, and is fixed in libguestfs E<ge> 1.16. For further information, see -https://bugzilla.redhat.com/show_bug.cgi?id=788642 +L<https://bugzilla.redhat.com/show_bug.cgi?id=788642> =head1 ENVIRONMENT VARIABLES diff --git a/examples/guestfs-faq.pod b/examples/guestfs-faq.pod index b33c0f24..7ca534ab 100644 --- a/examples/guestfs-faq.pod +++ b/examples/guestfs-faq.pod @@ -119,7 +119,7 @@ L<https://www.redhat.com/mailman/listinfo/virt-tools-list> Please use the following link to enter a bug in Bugzilla: - https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools +L<https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools> Include as much detail as you can and a way to reproduce the problem. diff --git a/examples/guestfs-recipes.pod b/examples/guestfs-recipes.pod index 72299528..3b91e60c 100644 --- a/examples/guestfs-recipes.pod +++ b/examples/guestfs-recipes.pod @@ -2,10 +2,6 @@ =begin comment -pod2man and pod2html have differing bugs which makes it hard to write -URLs here. The only way which works for both sorts of output is to -just write the URL directly. Do NOT use L<...> for URLs. - We break with tradition here and don't use ALL CAPS for the section headings, as this makes them much easier to read. @@ -25,7 +21,7 @@ libguestfs, L<guestfish(1)> and the virt tools. The link below contains a small program which can be used to audit a Linux virtual machine to see what setuid and setgid files it contains. -https://rwmj.wordpress.com/2010/12/15/tip-audit-virtual-machine-for-setuid-files/#content +L<https://rwmj.wordpress.com/2010/12/15/tip-audit-virtual-machine-for-setuid-files/#content> =head1 Change the background image in a Windows XP VM @@ -34,8 +30,8 @@ background image for a user of a Windows XP VM. Unfortunately the technique appears to be substantially different for each version of Windows. -https://lists.fedoraproject.org/pipermail/virt/2011-May/002655.html -https://lists.fedoraproject.org/pipermail/virt/2011-May/002658.html +L<https://lists.fedoraproject.org/pipermail/virt/2011-May/002655.html> +L<https://lists.fedoraproject.org/pipermail/virt/2011-May/002658.html> =head1 Cloning a virtual machine (Linux) @@ -43,12 +39,12 @@ The guestfish technique described in the link below works well for most Linux VMs. Depending on the Linux distro you may need to change the paths slightly. -https://rwmj.wordpress.com/2010/09/24/tip-my-procedure-for-cloning-a-fedora-vm/#content +L<https://rwmj.wordpress.com/2010/09/24/tip-my-procedure-for-cloning-a-fedora-vm/#content> Avoid L<virt-clone(1)>. Currently what to do about virt-clone is under discussion. -https://www.redhat.com/archives/virt-tools-list/2011-May/msg00019.html +L<https://www.redhat.com/archives/virt-tools-list/2011-May/msg00019.html> =head1 Cloning a virtual machine (Windows) @@ -57,8 +53,8 @@ straightforward. Currently there is code in the Aeolus Oz project which does this (using libguestfs). As part of our review of the virt-clone tool, we may add sysprepping ability. -https://github.com/clalancette/oz -https://www.redhat.com/archives/virt-tools-list/2011-May/msg00019.html +L<https://github.com/clalancette/oz> +L<https://www.redhat.com/archives/virt-tools-list/2011-May/msg00019.html> =head1 Convert a CD-ROM / DVD / ISO to a tarball @@ -75,7 +71,7 @@ To export just a subdirectory, eg. C</files>, do: You can use the L<guestfish(1)> I<-N> option to create empty disk images. The useful guide below explains the options available. -https://rwmj.wordpress.com/2010/09/08/new-guestfish-n-options-in-1-5-9/#content +L<https://rwmj.wordpress.com/2010/09/08/new-guestfish-n-options-in-1-5-9/#content> =head1 Dump raw filesystem content from inside a disk image or VM @@ -152,7 +148,7 @@ To get the output as a compressed tarball, do: Although it sounds tempting, this is usually not a reliable way to get a backup from a running guest. See the entry in the FAQ: -http://libguestfs.org/FAQ.html#backup +L<http://libguestfs.org/FAQ.html#backup> =head1 Find out which user is using the most space @@ -181,7 +177,7 @@ using the most space in their home directory: The link below explains the many different possible techniques for getting the last assigned DHCP address of a virtual machine. -https://rwmj.wordpress.com/2011/03/31/tip-code-for-getting-dhcp-address-from-a-virtual-machine-disk-image/#content +L<https://rwmj.wordpress.com/2011/03/31/tip-code-for-getting-dhcp-address-from-a-virtual-machine-disk-image/#content> In the libguestfs source examples directory you will find the latest version of the C<virt-dhcp-address.c> program. @@ -217,7 +213,7 @@ language: The link below contains a program to print the default boot kernel for a Linux VM. -https://rwmj.wordpress.com/2010/10/30/tip-use-augeas-to-get-the-default-boot-kernel-for-a-vm/#content +L<https://rwmj.wordpress.com/2010/10/30/tip-use-augeas-to-get-the-default-boot-kernel-for-a-vm/#content> It uses Augeas, and the technique is generally applicable for many different tasks, such as: @@ -246,7 +242,7 @@ listing who was logged in recently =back -http://augeas.net/ +L<http://augeas.net/> =head1 Install RPMs in a guest @@ -256,7 +252,7 @@ script that installs them next time the guest is booted. You could use this technique to install vital security updates in an offline guest. -https://rwmj.wordpress.com/2010/12/01/tip-install-rpms-in-a-guest/#content +L<https://rwmj.wordpress.com/2010/12/01/tip-install-rpms-in-a-guest/#content> =head1 List applications installed in a VM @@ -318,21 +314,21 @@ The link below contains a script that can be used to list out the services from a Windows VM, and whether those services run at boot time or are loaded on demand. -https://rwmj.wordpress.com/2010/12/10/tip-list-services-in-a-windows-guest/#content +L<https://rwmj.wordpress.com/2010/12/10/tip-list-services-in-a-windows-guest/#content> =head1 Make a disk image sparse The link below contains some guides for making a disk image sparse (or reintroducing sparseness). -https://rwmj.wordpress.com/2010/10/19/tip-making-a-disk-image-sparse/#content +L<https://rwmj.wordpress.com/2010/10/19/tip-making-a-disk-image-sparse/#content> =head1 Monitor disk usage over time You can use L<virt-df(1)> to monitor disk usage of your guests over time. The link below contains a guide. -http://virt-tools.org/learning/advanced-virt-df/ +L<http://virt-tools.org/learning/advanced-virt-df/> =head1 Reading the Windows Event Log from Windows Vista (or later) @@ -340,7 +336,7 @@ L<guestfish(1)> plus the tools described in the link below can be used to read out the Windows Event Log from any virtual machine running Windows Vista or a later version. -https://rwmj.wordpress.com/2011/04/17/decoding-the-windows-event-log-using-guestfish/#content +L<https://rwmj.wordpress.com/2011/04/17/decoding-the-windows-event-log-using-guestfish/#content> =head1 Remove root password (Linux) @@ -356,7 +352,7 @@ password from a Windows VM, or to be more precise, it gives you a command prompt the next time you log in which you can use to bypass any security: -https://mdbooth.wordpress.com/2010/10/18/resetting-a-windows-guests-administrator-password-with-guestfish/ +L<https://mdbooth.wordpress.com/2010/10/18/resetting-a-windows-guests-administrator-password-with-guestfish/> =head1 Unpack a live CD @@ -364,14 +360,14 @@ Linux live CDs often contain multiple layers of disk images wrapped like a Russian doll. You can use L<guestfish(1)> to look inside these multiple layers, as outlined in the guide below. -https://rwmj.wordpress.com/2009/07/15/unpack-the-russian-doll-of-a-f11-live-cd/#content +L<https://rwmj.wordpress.com/2009/07/15/unpack-the-russian-doll-of-a-f11-live-cd/#content> =head1 Uploading and downloading files The link below contains general tips on uploading (copying in) and downloading (copying out) files from VMs. -https://rwmj.wordpress.com/2010/12/02/tip-uploading-and-downloading/#content +L<https://rwmj.wordpress.com/2010/12/02/tip-uploading-and-downloading/#content> =head1 Use libguestfs tools on VMware ESX guests @@ -379,7 +375,7 @@ The link below explains how to use libguestfs, L<guestfish(1)> and the virt tools on any VMware ESX guests, by first sharing the VMware VMFS over sshfs. -https://rwmj.wordpress.com/2011/05/10/tip-use-libguestfs-on-vmware-esx-guests/#content +L<https://rwmj.wordpress.com/2011/05/10/tip-use-libguestfs-on-vmware-esx-guests/#content> =head1 SEE ALSO diff --git a/examples/guestfs-testing.pod b/examples/guestfs-testing.pod index c35c3b86..2bd854f2 100644 --- a/examples/guestfs-testing.pod +++ b/examples/guestfs-testing.pod @@ -40,7 +40,7 @@ After a few runs, the time should settle down to a few seconds (under How to check for hardware virt: -http://virt-tools.org/learning/check-hardware-virt/ +L<http://virt-tools.org/learning/check-hardware-virt/> If the command above does not work at all, use L<libguestfs-test-tool(1)>. @@ -135,8 +135,8 @@ Run: Now try to load this into your favorite spreadsheet or database. Are the results reproduced faithfully in the spreadsheet/database? -http://www.postgresql.org/docs/8.1/static/sql-copy.html -http://dev.mysql.com/doc/refman/5.1/en/load-data.html +L<http://www.postgresql.org/docs/8.1/static/sql-copy.html> +L<http://dev.mysql.com/doc/refman/5.1/en/load-data.html> =head2 B<*> Edit a file in a B<shut off> guest. diff --git a/src/guestfs.pod b/src/guestfs.pod index a1dc9aec..72a55064 100644 --- a/src/guestfs.pod +++ b/src/guestfs.pod @@ -1337,7 +1337,7 @@ be found in the section L</RUNNING COMMANDS>. =head2 CVE-2010-3851 -https://bugzilla.redhat.com/642934 +L<https://bugzilla.redhat.com/642934> This security bug concerns the automatic disk format detection that qemu does on disk images. |