Skip to content
This repository was archived by the owner on Jan 22, 2026. It is now read-only.

Commit cff74a5

Browse files
committed
Prep for release (Update translations, NEWS, version, ...)
1 parent 7b3cff6 commit cff74a5

20 files changed

Lines changed: 4794 additions & 3735 deletions

ChangeLog

Lines changed: 511 additions & 2 deletions
Large diffs are not rendered by default.

NEWS

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,14 @@
11
Virtinst News
22
=================
33

4+
Release 0.501.0 (December 3, 2009)
5+
----------------------------------
6+
- virt-install now attempts --os-variant detection by default. This can be
7+
disabled with '--os-variant none' (distro detection currently only
8+
works for URL installs)
9+
- New --disk option 'format', for creating image formats like qcow2 or vmdk
10+
- Many improvements and bugfixes
11+
412
Release 0.500.0 (July 28, 2009)
513
-------------------------------
614

man/en/Makefile

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,10 +9,10 @@ clean:
99
rm *.1 *.5
1010

1111
%.1: %.pod
12-
pod2man --center=$(CENTER) $< $@
12+
pod2man --center=$(CENTER) --release="" $< $@
1313

1414
%.html: %.pod
1515
pod2html --header --podpath . --infile $< --outfile $@
1616

1717
virt-image.5: virt-image-xml.pod
18-
pod2man --center=$(CENTER) --section=5 --name=virt-image $< $@
18+
pod2man --center=$(CENTER) --section=5 --release="" --name=virt-image $< $@

man/en/virt-clone.1

Lines changed: 32 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -132,7 +132,7 @@
132132
.\" ========================================================================
133133
.\"
134134
.IX Title "VIRT-CLONE 1"
135-
.TH VIRT-CLONE 1 "2009-03-23" "perl v5.10.0" "Virtual Machine Install Tools"
135+
.TH VIRT-CLONE 1 "2009-12-01" "" "Virtual Machine Install Tools"
136136
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
137137
.\" way too many mistakes in technical documents.
138138
.if n .ad l
@@ -151,9 +151,10 @@ with an identical virtual hardware configuration. Elements which require
151151
uniqueness will be updated to avoid a clash between old and new guests.
152152
.PP
153153
By default, virt-clone will show an error if the necessary information to
154-
clone the guest is not provided. An interactive mode is available
155-
with the \-\-prompt option, but this will only ask for the minimum required
156-
options.
154+
clone the guest is not provided. The \-\-auto\-clone option will generate
155+
all needed input, aside from the source guest to clone. An interactive mode
156+
is available with the \-\-prompt option, but this will only ask for the
157+
minimum required options.
157158
.SH "OPTIONS"
158159
.IX Header "OPTIONS"
159160
Most options are not required. Minimum requirements are \-\-original or
@@ -177,6 +178,22 @@ since it is not possible to safely clone active guests at this time.
177178
Libvirt guest xml file to use as the original guest. The guest does not need to
178179
be defined on the libvirt connection. This takes the place of the
179180
\&\f(CW\*(C`\-\-original\*(C'\fR parameter.
181+
.IP "\-\-auto\-clone" 2
182+
.IX Item "--auto-clone"
183+
Generate a new guest name, and paths for new storage.
184+
.Sp
185+
An example or possible generated output:
186+
.Sp
187+
.Vb 2
188+
\& Original name : MyVM
189+
\& Generated clone name : MyVM\-clone
190+
\&
191+
\& Original disk path : /home/user/foobar.img
192+
\& Generated disk path : /home/user/foobar\-clone.img
193+
.Ve
194+
.Sp
195+
If generated names collide with existing VMs or storage, a number is appended,
196+
such as foobar\-clone\-1.img, or MyVM\-clone\-3.
180197
.IP "\-n \s-1NAME\s0, \-\-name=NAME" 2
181198
.IX Item "-n NAME, --name=NAME"
182199
Name of the new guest virtual machine instance. This must be unique amongst
@@ -233,6 +250,15 @@ Specifically enable prompting for required information. Default prompting
233250
is off.
234251
.SH "EXAMPLES"
235252
.IX Header "EXAMPLES"
253+
Clone the guest called \f(CW\*(C`demo\*(C'\fR on the default connection, auto generating
254+
a new name and disk clone path.
255+
.PP
256+
.Vb 3
257+
\& # virt\-clone \e
258+
\& \-\-original demo \e
259+
\& \-\-auto\-clone
260+
.Ve
261+
.PP
236262
Clone the guest called \f(CW\*(C`demo\*(C'\fR which has a single disk to copy
237263
.PP
238264
.Vb 4
@@ -262,17 +288,15 @@ new guest can do a filesystem resize when it boots.
262288
\& \-\-connect qemu:///system \e
263289
\& \-\-name demo \e
264290
\& \-\-file /dev/HostVG/DemoVM \e
265-
\& \-\-mac 54:52:00:34:11:54
291+
\& \-\-mac 52:54:00:34:11:54
266292
.Ve
267293
.SH "AUTHOR"
268294
.IX Header "AUTHOR"
269295
Written by Kazuki Mizushima, and a team of many other contributors. See the \s-1AUTHORS\s0
270296
file in the source distribution for the complete list of credits.
271297
.SH "BUGS"
272298
.IX Header "BUGS"
273-
Report bugs to the mailing list \f(CW\*(C`http://www.redhat.com/mailman/listinfo/et\-mgmt\-tools\*(C'\fR
274-
or directly to BugZilla \f(CW\*(C`http://bugzilla.redhat.com/bugzilla/\*(C'\fR against the
275-
\&\f(CW\*(C`Fedora\*(C'\fR product, and the \f(CW\*(C`python\-virtinst\*(C'\fR component.
299+
Please see http://virt\-manager.org/page/BugReporting
276300
.SH "COPYRIGHT"
277301
.IX Header "COPYRIGHT"
278302
Copyright (C) Fujitsu Limited 2007, and various contributors.

man/en/virt-convert.1

Lines changed: 5 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
.\" Automatically generated by Pod::Man 2.16 (Pod::Simple 3.05)
1+
.\" Automatically generated by Pod::Man 2.16 (Pod::Simple 3.07)
22
.\"
33
.\" Standard preamble:
44
.\" ========================================================================
@@ -132,7 +132,7 @@
132132
.\" ========================================================================
133133
.\"
134134
.IX Title "VIRT-CONVERT 1"
135-
.TH VIRT-CONVERT 1 "2009-03-03" "perl v5.10.0" "Virtual Machine Install Tools"
135+
.TH VIRT-CONVERT 1 "2009-12-01" "" "Virtual Machine Install Tools"
136136
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
137137
.\" way too many mistakes in technical documents.
138138
.if n .ad l
@@ -171,7 +171,7 @@ Show the help message and exit
171171
.IX Subsection "Conversion Options"
172172
.IP "\-i format" 2
173173
.IX Item "-i format"
174-
Input format. Currently, \f(CW\*(C`vmx\*(C'\fR and \f(CW\*(C`virt\-image\*(C'\fR are supported.
174+
Input format. Currently, \f(CW\*(C`vmx\*(C'\fR, \f(CW\*(C`virt\-image\*(C'\fR, and \f(CW\*(C`ovf\*(C'\fR are supported.
175175
.IP "\-o format" 2
176176
.IX Item "-o format"
177177
Output format. Currently, \f(CW\*(C`vmx\*(C'\fR and \f(CW\*(C`virt\-image\*(C'\fR are supported.
@@ -244,9 +244,7 @@ Written by Joey Boggs and John Levon
244244
See the \s-1AUTHORS\s0 file in the source distribution for the complete list of credits.
245245
.SH "BUGS"
246246
.IX Header "BUGS"
247-
Report bugs to the mailing list \f(CW\*(C`http://www.redhat.com/mailman/listinfo/et\-mgmt\-tools\*(C'\fR
248-
or directly to BugZilla \f(CW\*(C`http://bugzilla.redhat.com/bugzilla/\*(C'\fR against the
249-
\&\f(CW\*(C`Fedora\*(C'\fR product, and the \f(CW\*(C`python\-virtinst\*(C'\fR component.
247+
Please see http://virt\-manager.org/page/BugReporting
250248
.SH "COPYRIGHT"
251249
.IX Header "COPYRIGHT"
252250
Copyright (C) 2006\-2008 Red Hat, Inc, and various contributors.
@@ -255,5 +253,4 @@ Public License \f(CW\*(C`http://www.gnu.org/licenses/gpl.html\*(C'\fR. There is
255253
permitted by law.
256254
.SH "SEE ALSO"
257255
.IX Header "SEE ALSO"
258-
\&\fIvirt\-pack\fR\|(1), \fIvirt\-image\fR\|(5), the project website
259-
\&\f(CW\*(C`http://virt\-manager.org\*(C'\fR
256+
\&\fIvirt\-image\fR\|(5), the project website \f(CW\*(C`http://virt\-manager.org\*(C'\fR

man/en/virt-image.1

Lines changed: 11 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -132,7 +132,7 @@
132132
.\" ========================================================================
133133
.\"
134134
.IX Title "VIRT-IMAGE 1"
135-
.TH VIRT-IMAGE 1 "2009-03-23" "perl v5.10.0" "Virtual Machine Install Tools"
135+
.TH VIRT-IMAGE 1 "2009-12-01" "" "Virtual Machine Install Tools"
136136
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
137137
.\" way too many mistakes in technical documents.
138138
.if n .ad l
@@ -213,11 +213,10 @@ Disables \s-1ACPI\s0 for fully virtualized guest (overrides value in \s-1XML\s0
213213
.IX Subsection "Networking Configuration"
214214
.IP "\-m \s-1MAC\s0, \-\-mac=MAC" 2
215215
.IX Item "-m MAC, --mac=MAC"
216-
Fixed \s-1MAC\s0 address for the guest. See \fIvirt\-install\fR\|(1) for details
216+
This is deprecated in favor of \f(CW\*(C`\-\-network ...,mac=MAC,...\*(C'\fR
217217
.IP "\-b \s-1BRIDGE\s0, \-\-bridge=BRIDGE" 2
218218
.IX Item "-b BRIDGE, --bridge=BRIDGE"
219-
Bridge device to connect the guest \s-1NIC\s0 to. This is deprecated in favor of
220-
\&\f(CW\*(C`\-\-network\*(C'\fR
219+
This is deprecated in favor of \f(CW\*(C`\-\-network bridge=BRIDGE\*(C'\fR
221220
.IP "\-w \s-1NETWORK\s0, \-\-network=NETWORK" 2
222221
.IX Item "-w NETWORK, --network=NETWORK"
223222
Connect the guest to the host network. See \fIvirt\-install\fR\|(1) for details
@@ -233,6 +232,13 @@ the host. See \fIvirt\-install\fR\|(1) for details
233232
.IX Item "--vncport=VNCPORT"
234233
Request a permanent, statically assigned port number for the guest \s-1VNC\s0
235234
console. See \fIvirt\-install\fR\|(1) for details
235+
.IP "\-\-vnclisten=VNCLISTEN" 2
236+
.IX Item "--vnclisten=VNCLISTEN"
237+
Address to listen on for \s-1VNC\s0 connections. See \fIvirt\-install\fR\|(1) for details.
238+
.IP "\-k \s-1KEYMAP\s0, \-\-keymap=KEYMAP" 2
239+
.IX Item "-k KEYMAP, --keymap=KEYMAP"
240+
Request that the virtual \s-1VNC\s0 console be configured to run with a non-English
241+
keyboard layout.
236242
.IP "\-\-sdl" 2
237243
.IX Item "--sdl"
238244
Setup a virtual console in the guest and display an \s-1SDL\s0 window in the
@@ -241,10 +247,6 @@ host to render the output. See \fIvirt\-install\fR\|(1) for details
241247
.IX Item "--nographics"
242248
Do not attach a graphical device to the guest. See
243249
\&\fIvirt\-install\fR\|(1) for details
244-
.IP "\-k \s-1KEYMAP\s0, \-\-keymap=KEYMAP" 2
245-
.IX Item "-k KEYMAP, --keymap=KEYMAP"
246-
Request that the virtual console be configured to run with a non-English
247-
keyboard layout.
248250
.Sh "Miscellaneous Options"
249251
.IX Subsection "Miscellaneous Options"
250252
.IP "\-p, \-\-print" 2
@@ -296,10 +298,7 @@ Written by David Lutterkort. See the \s-1AUTHORS\s0 file in the source
296298
distribution for the complete list of credits.
297299
.SH "BUGS"
298300
.IX Header "BUGS"
299-
Report bugs to the mailing list
300-
\&\f(CW\*(C`http://www.redhat.com/mailman/listinfo/et\-mgmt\-tools\*(C'\fR or directly to
301-
BugZilla \f(CW\*(C`http://bugzilla.redhat.com/bugzilla/\*(C'\fR against the \f(CW\*(C`Fedora\*(C'\fR
302-
product, and the \f(CW\*(C`python\-virtinst\*(C'\fR component.
301+
Please see http://virt\-manager.org/page/BugReporting
303302
.SH "COPYRIGHT"
304303
.IX Header "COPYRIGHT"
305304
Copyright (C) 2006\-2007 Red Hat, Inc, and various contributors.

man/en/virt-image.5

Lines changed: 32 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
1+
.\" Automatically generated by Pod::Man 2.16 (Pod::Simple 3.07)
22
.\"
33
.\" Standard preamble:
44
.\" ========================================================================
@@ -25,11 +25,11 @@
2525
..
2626
.\" Set up some character translations and predefined strings. \*(-- will
2727
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
28-
.\" double quote, and \*(R" will give a right double quote. | will give a
29-
.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to
30-
.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C'
31-
.\" expand to `' in nroff, nothing in troff, for use with C<>.
32-
.tr \(*W-|\(bv\*(Tr
28+
.\" double quote, and \*(R" will give a right double quote. \*(C+ will
29+
.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
30+
.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
31+
.\" nothing in troff, for use with C<>.
32+
.tr \(*W-
3333
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
3434
.ie n \{\
3535
. ds -- \(*W-
@@ -48,22 +48,25 @@
4848
. ds R" ''
4949
'br\}
5050
.\"
51+
.\" Escape single quotes in literal strings from groff's Unicode transform.
52+
.ie \n(.g .ds Aq \(aq
53+
.el .ds Aq '
54+
.\"
5155
.\" If the F register is turned on, we'll generate index entries on stderr for
5256
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
5357
.\" entries marked with X<> in POD. Of course, you'll have to process the
5458
.\" output yourself in some meaningful fashion.
55-
.if \nF \{\
59+
.ie \nF \{\
5660
. de IX
5761
. tm Index:\\$1\t\\n%\t"\\$2"
5862
..
5963
. nr % 0
6064
. rr F
6165
.\}
62-
.\"
63-
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
64-
.\" way too many mistakes in technical documents.
65-
.hy 0
66-
.if n .na
66+
.el \{\
67+
. de IX
68+
..
69+
.\}
6770
.\"
6871
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
6972
.\" Fear. Run. Save yourself. No user-serviceable parts.
@@ -129,7 +132,11 @@
129132
.\" ========================================================================
130133
.\"
131134
.IX Title "virt-image 5"
132-
.TH virt-image 5 "2008-05-08" "perl v5.8.8" "Virtual Machine Install Tools"
135+
.TH virt-image 5 "2009-12-01" "" "Virtual Machine Install Tools"
136+
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
137+
.\" way too many mistakes in technical documents.
138+
.if n .ad l
139+
.nh
133140
.SH "NAME"
134141
virt\-image \- Format of the virtual image XML descriptor
135142
.SH "DESCRIPTION"
@@ -223,7 +230,7 @@ element, it defaults to \f(CW\*(C`on\*(C'\fR.
223230
.IX Item "The details of booting the image's operating system"
224231
The \fBos\fR element for fully-virtualized \f(CW\*(C`hvm\*(C'\fR guests contains a \fBloader\fR
225232
element whose \fBdev\fR attribute indicates whether to boot off a hard disk
226-
(\f(CW\*(C`dev='hd'\*(C'\fR) or off a CD-ROM (\f(CW\*(C`dev='cdrom'\*(C'\fR)
233+
(\f(CW\*(C`dev=\*(Aqhd\*(Aq\*(C'\fR) or off a CD-ROM (\f(CW\*(C`dev=\*(Aqcdrom\*(Aq\*(C'\fR)
227234
.Sp
228235
For paravirtualized guests, the \fBos\fR element either contains a
229236
\&\f(CW\*(C`<loader>pygrub</loader>\*(C'\fR element, indicating that the guest should be
@@ -276,8 +283,8 @@ The image descriptor below can be used to create a virtual machine running
276283
the System Rescue \s-1CD\s0 (\f(CW\*(C`http://www.sysresccd.org/\*(C'\fR) Besides the descriptor,
277284
you only need the \s-1ISO\s0 image from the System Rescue \s-1CD\s0 website.
278285
.PP
279-
.Vb 27
280-
\& <?xml version="1.0" encoding="UTF-8"?>
286+
.Vb 10
287+
\& <?xml version="1.0" encoding="UTF\-8"?>
281288
\& <image>
282289
\& <name>sysresccd</name>
283290
\& <domain>
@@ -300,7 +307,7 @@ you only need the \s-1ISO\s0 image from the System Rescue \s-1CD\s0 website.
300307
\& </domain>
301308
\& <storage>
302309
\& <disk file="root.raw" use="scratch" size="100" format="raw"/>
303-
\& <disk id="sysresc" file="isos/systemrescuecd.iso"
310+
\& <disk id="sysresc" file="isos/systemrescuecd.iso"
304311
\& use="system" format="iso"/>
305312
\& </storage>
306313
\& </image>
@@ -309,23 +316,21 @@ you only need the \s-1ISO\s0 image from the System Rescue \s-1CD\s0 website.
309316
To create a virtual machine, save the above \s-1XML\s0 in \fIimage.xml\fR and run:
310317
.PP
311318
.Vb 1
312-
\& # virt-image --vnc image.xml
319+
\& # virt\-image \-\-vnc image.xml
313320
.Ve
314321
.SH "AUTHOR"
315322
.IX Header "AUTHOR"
316-
Written by David Lutterkort. See the \s-1AUTHORS\s0 file in the source distribution for
317-
the complete list of credits.
323+
Written by David Lutterkort. See the \s-1AUTHORS\s0 file in the source distribution
324+
for the complete list of credits.
318325
.SH "BUGS"
319326
.IX Header "BUGS"
320-
Report bugs to the mailing list \f(CW\*(C`http://www.redhat.com/mailman/listinfo/et\-mgmt\-tools\*(C'\fR
321-
or directly to BugZilla \f(CW\*(C`http://bugzilla.redhat.com/bugzilla/\*(C'\fR against the
322-
\&\f(CW\*(C`Fedora\*(C'\fR product, and the \f(CW\*(C`python\-virtinst\*(C'\fR component.
327+
Please see \f(CW\*(C`http://virt\-manager.org/page/BugReporting\*(C'\fR
323328
.SH "COPYRIGHT"
324329
.IX Header "COPYRIGHT"
325-
Copyright (C) 2006\-2007 Red Hat, Inc, and various contributors.
326-
This is free software. You may redistribute copies of it under the terms of the \s-1GNU\s0 General
327-
Public License \f(CW\*(C`http://www.gnu.org/licenses/gpl.html\*(C'\fR. There is \s-1NO\s0 \s-1WARRANTY\s0, to the extent
328-
permitted by law.
330+
Copyright (C) 2006\-2007 Red Hat, Inc, and various contributors.
331+
This is free software. You may redistribute copies of it under the terms
332+
of the \s-1GNU\s0 General Public License \f(CW\*(C`http://www.gnu.org/licenses/gpl.html\*(C'\fR.
333+
There is \s-1NO\s0 \s-1WARRANTY\s0, to the extent permitted by law.
329334
.SH "SEE ALSO"
330335
.IX Header "SEE ALSO"
331336
\&\fIvirt\-image\fR\|(1), \fIvirt\-install\fR\|(1), the project website

0 commit comments

Comments
 (0)