[libvirt] [PATCH 1/2] Standardise ./configure --help options reporting.

Daniel P. Berrange berrange at redhat.com
Sun Jan 17 17:03:20 UTC 2010


On Sun, Jan 17, 2010 at 03:48:45PM +0100, Diego Elio Petten? wrote:
> Always use AC_HELP_STRING for the help text for options at ./configure,
> so that the output is properly aligned.
> 
> Use proper quadrigraphs for outputting the brackets.
> 
> Always use autoconf-style [default=$foo] output to state the default, both
> where it was stated before and where it wasn't.
> 
> This time, include Matthias Bolte notes regarding defaults, and removing
> PFX specification from phyp.
> ---
>  configure.in |  100 +++++++++++++++++++++++++++++-----------------------------
>  1 files changed, 50 insertions(+), 50 deletions(-)
> 
> diff --git a/configure.in b/configure.in
> index 012a96f..447d57e 100644
> --- a/configure.in
> +++ b/configure.in
> @@ -205,33 +205,33 @@ fi
>  
>  dnl Allow to build without Xen, QEMU/KVM, test or remote driver
>  AC_ARG_WITH([xen],
> -[  --with-xen              add XEN support (on)],[],[with_xen=yes])
> +  AC_HELP_STRING([--with-xen], [add XEN support @<:@default=yes@:>@]),[],[with_xen=yes])
>  AC_ARG_WITH([xen-inotify],
> -[  --with-xen-inotify      add XEN inotify support (on)],[],[with_xen_inotify=check])
> +  AC_HELP_STRING([--with-xen-inotify], [add XEN inotify support @<:@default=check@:>@]),[],[with_xen_inotify=check])
>  AC_ARG_WITH([qemu],
> -[  --with-qemu             add QEMU/KVM support (on)],[],[with_qemu=yes])
> +  AC_HELP_STRING([--with-qemu], [add QEMU/KVM support @<:@default=yes@:>@]),[],[with_qemu=yes])
>  AC_ARG_WITH([uml],
> -[  --with-uml              add UML support (on)],[],[with_uml=check])
> +  AC_HELP_STRING([--with-uml], [add UML support @<:@default=check@:>@]),[],[with_uml=check])
>  AC_ARG_WITH([openvz],
> -[  --with-openvz           add OpenVZ support (on)],[],[with_openvz=yes])
> +  AC_HELP_STRING([--with-openvz], [add OpenVZ support @<:@default=yes@:>@]),[],[with_openvz=yes])
>  AC_ARG_WITH([libssh2],
> -[  --with-libssh2=[PFX]       libssh2 location],[],[with_libssh2=yes])
> +  AC_HELP_STRING([--with-libssh2=@<:@PFX@:>@], [libssh2 location @<:@default=/usr/local/lib@:>@]),[],[with_libssh2=yes])
>  AC_ARG_WITH([phyp],
> -[  --with-phyp=[PFX]         add PHYP support (on)],[],[with_phyp=check])
> +  AC_HELP_STRING([--with-phyp], [add PHYP support @<:@default=check@:>@]),[],[with_phyp=check])
>  AC_ARG_WITH([vbox],
> -[  --with-vbox             add VirtualBox support (on)],[],[with_vbox=yes])
> +  AC_HELP_STRING([--with-vbox], [add VirtualBox support @<:@default=yes@:>@]),[],[with_vbox=yes])
>  AC_ARG_WITH([lxc],
> -[  --with-lxc              add Linux Container support (on)],[],[with_lxc=check])
> +  AC_HELP_STRING([--with-lxc], [add Linux Container support @<:@default=check@:>@]),[],[with_lxc=check])
>  AC_ARG_WITH([one],
> -[  --with-one              add ONE support (on)],[],[with_one=check])
> +  AC_HELP_STRING([--with-one], [add ONE support @<:@default=check@:>@]),[],[with_one=check])
>  AC_ARG_WITH([esx],
> -[  --with-esx              add ESX support (on)],[],[with_esx=check])
> +  AC_HELP_STRING([--with-esx], [add ESX support @<:@default=check@:>@]),[],[with_esx=check])
>  AC_ARG_WITH([test],
> -[  --with-test             add test driver support (on)],[],[with_test=yes])
> +  AC_HELP_STRING([--with-test], [add test driver support @<:@default=yes@:>@]),[],[with_test=yes])
>  AC_ARG_WITH([remote],
> -[  --with-remote           add remote driver support (on)],[],[with_remote=yes])
> +  AC_HELP_STRING([--with-remote], [add remote driver support @<:@default=yes@:>@]),[],[with_remote=yes])
>  AC_ARG_WITH([libvirtd],
> -[  --with-libvirtd         add libvirtd support (on)],[],[with_libvirtd=yes])
> +  AC_HELP_STRING([--with-libvirtd], [add libvirtd support @<:@default=yes@:>@]),[],[with_libvirtd=yes])
>  
>  dnl
>  dnl specific tests to setup DV devel environments with debug etc ...
> @@ -245,8 +245,8 @@ AC_SUBST([STATIC_BINARIES])
>  
>  dnl --enable-debug=(yes|no)
>  AC_ARG_ENABLE([debug],
> -              [AC_HELP_STRING([--enable-debug=no/yes],
> -                             [enable debugging output])],[],[enable_debug=yes])
> +              [AC_HELP_STRING([--enable-debug=@<:@no|yes@:>@],
> +                             [enable debugging output @<:@default=yes@:>@])],[],[enable_debug=yes])
>  AM_CONDITIONAL([ENABLE_DEBUG], test x"$enable_debug" = x"yes")
>  if test x"$enable_debug" = x"yes"; then
>     AC_DEFINE([ENABLE_DEBUG], [], [whether debugging is enabled])
> @@ -254,7 +254,7 @@ fi
>  
>  
>  AC_MSG_CHECKING([where to write libvirtd PID file])
> -AC_ARG_WITH([remote-pid-file], [AC_HELP_STRING([--with-remote-pid-file=[pidfile|none]], [PID file for libvirtd])])
> +AC_ARG_WITH([remote-pid-file], [AC_HELP_STRING([--with-remote-pid-file=@<:@pidfile|none@:>@], [PID file for libvirtd])])
>  if test "x$with_remote_pid_file" == "x" ; then
>     REMOTE_PID_FILE="$localstatedir/run/libvirtd.pid"
>  elif test "x$with_remote_pid_file" == "xnone" ; then
> @@ -270,8 +270,8 @@ dnl init script flavor
>  dnl
>  AC_MSG_CHECKING([for init script flavor])
>  AC_ARG_WITH([init-script],
> -            [AC_HELP_STRING([--with-init-script=[redhat|auto|none]],
> -		     [Style of init script to install (defaults to auto)])])
> +            [AC_HELP_STRING([--with-init-script=@<:@redhat|auto|none@:>@],
> +		     [Style of init script to install @<:@default=auto@:>@])])
>  if test "x$with_init_script" = "x" -o "x$with_init_script" = "xauto"; then
>      if test -f /etc/redhat-release ; then
>          with_init_script=redhat
> @@ -284,8 +284,8 @@ AC_MSG_RESULT($with_init_script)
>  
>  dnl RHEL-5 has a peculiar version of Xen, which requires some special casing
>  AC_ARG_WITH([rhel5-api],
> -	[AC_HELP_STRING([--with-rhel5-api=[ARG]],
> -		[build for the RHEL-5 API [default=no]])])
> +	[AC_HELP_STRING([--with-rhel5-api=@<:@ARG@:>@],
> +		[build for the RHEL-5 API @<:@default=no@:>@])])
>  if test x"$with_rhel5_api" = x"yes"; then
>     AC_DEFINE([WITH_RHEL5_API], [1], [whether building for the RHEL-5 API])
>  fi
> @@ -509,7 +509,7 @@ LIBXML_CFLAGS=""
>  LIBXML_LIBS=""
>  LIBXML_FOUND="no"
>  
> -AC_ARG_WITH([libxml], [  --with-libxml=[PFX]       libxml2 location])
> +AC_ARG_WITH([libxml], AC_HELP_STRING([--with-libxml=@<:@PFX@:>@], [libxml2 location]))
>  if test "x$with_libxml" = "xno" ; then
>      AC_MSG_CHECKING(for libxml2 libraries >= $LIBXML_REQUIRED)
>      AC_MSG_ERROR([libxml2 >= $LIBXML_REQUIRED is required for libvirt])
> @@ -596,7 +596,7 @@ LIBS="$old_libs"
>  
>  dnl Cyrus SASL
>  AC_ARG_WITH([sasl],
> -  [  --with-sasl         use cyrus SASL for authentication],
> +  AC_HELP_STRING([--with-sasl], [use cyrus SASL for authentication @<:@default=check@:>@]),
>    [],
>    [with_sasl=check])
>  
> @@ -651,7 +651,7 @@ AC_SUBST([SASL_LIBS])
>  
>  dnl YAJL JSON library http://lloyd.github.com/yajl/
>  AC_ARG_WITH([yajl],
> -  [  --with-yajl         use YAJL for JSON parsing/formatting],
> +  AC_HELP_STRING([--with-yajl], [use YAJL for JSON parsing/formatting @<:@default=check@:>@]),
>    [],
>    [with_yajl=check])
>  
> @@ -704,7 +704,7 @@ POLKIT_CFLAGS=
>  POLKIT_LIBS=
>  PKCHECK_PATH=
>  AC_ARG_WITH([polkit],
> -  [  --with-polkit         use PolicyKit for UNIX socket access checks],
> +  AC_HELP_STRING([--with-polkit], [use PolicyKit for UNIX socket access checks @<:@default=check@:>@]),
>    [],
>    [with_polkit=check])
>  
> @@ -762,7 +762,7 @@ AC_SUBST([POLKIT_LIBS])
>  
>  dnl Avahi library
>  AC_ARG_WITH([avahi],
> -  [  --with-avahi         use avahi to advertise remote daemon],
> +  AC_HELP_STRING([--with-avahi], [use avahi to advertise remote daemon @<:@default=check@:>@]),
>    [],
>    [with_avahi=check])
>  
> @@ -789,7 +789,7 @@ AC_SUBST([AVAHI_LIBS])
>  
>  dnl SELinux
>  AC_ARG_WITH([selinux],
> -  [  --with-selinux         use SELinux to manage security],
> +  AC_HELP_STRING([--with-selinux], [use SELinux to manage security @<:@default=check@:>@]),
>    [],
>    [with_selinux=check])
>  
> @@ -824,7 +824,7 @@ AC_SUBST([SELINUX_LIBS])
>  
>  
>  AC_ARG_WITH([secdriver-selinux],
> -  [  --with-secdriver-selinux         use SELinux security driver],
> +  AC_HELP_STRING([--with-secdriver-selinux], [use SELinux security driver @<:@default=check@:>@]),
>    [],
>    [with_secdriver_selinux=check])
>  
> @@ -862,7 +862,7 @@ AM_CONDITIONAL([WITH_SECDRIVER_SELINUX], [test "$with_secdriver_selinux" != "no"
>  
>  dnl AppArmor
>  AC_ARG_WITH([apparmor],
> -  [  --with-apparmor        use AppArmor to manage security],
> +  AC_HELP_STRING([--with-apparmor], [use AppArmor to manage security @<:@default=check@:>@]),
>    [],
>    [with_apparmor=check])
>  
> @@ -901,7 +901,7 @@ AC_SUBST([APPARMOR_LIBS])
>  
>  
>  AC_ARG_WITH([secdriver-apparmor],
> -  [  --with-secdriver-apparmor         use AppArmor security driver],
> +  AC_HELP_STRING([--with-secdriver-apparmor], [use AppArmor security driver @<:@default=check@:>@]),
>    [],
>    [with_secdriver_apparmor=check])
>  
> @@ -940,7 +940,7 @@ AM_CONDITIONAL([WITH_SECDRIVER_APPARMOR], [test "$with_secdriver_apparmor" != "n
>  
>  dnl NUMA lib
>  AC_ARG_WITH([numactl],
> -  [  --with-numactl         use numactl for host topology info],
> +  AC_HELP_STRING([--with-numactl], [use numactl for host topology info @<:@default=check@:>@]),
>    [],
>    [with_numactl=check])
>  
> @@ -1075,7 +1075,7 @@ AM_CONDITIONAL([WITH_PHYP],[test "$with_phyp" = "yes"])
>  
>  dnl libcap-ng
>  AC_ARG_WITH([capng],
> -  [  --with-capng         use libcap-ng to reduce libvirtd privileges],
> +  AC_HELP_STRING([--with-capng], [use libcap-ng to reduce libvirtd privileges @<:@default=check@:>@]),
>    [],
>    [with_capng=check])
>  
> @@ -1158,7 +1158,7 @@ AC_SUBST([VIRSH_LIBS])
>  
>  
>  AC_ARG_WITH([network],
> -[  --with-network              with virtual network driver (on)],[],[with_network=yes])
> +  AC_HELP_STRING([--with-network], [with virtual network driver @<:@default=yes@:>@]),[],[with_network=yes])
>  if test "$with_libvirtd" = "no" ; then
>    with_network=no
>  fi
> @@ -1176,7 +1176,7 @@ AM_CONDITIONAL([WITH_BRIDGE], [test "$with_bridge" = "yes"])
>  
>  dnl netcf library
>  AC_ARG_WITH([netcf],
> -[  --with-netcf         libnetcf support to configure physical host network interfaces],
> +  AC_HELP_STRING([--with-netcf], [libnetcf support to configure physical host network interfaces @<:@default=check@:>@]),
>  [], [with_netcf=check])
>  
>  NETCF_CFLAGS=
> @@ -1212,17 +1212,17 @@ AM_CONDITIONAL([WITH_SECRETS], [test "$with_secrets" = "yes"])
>  
>  
>  AC_ARG_WITH([storage-fs],
> -[  --with-storage-fs           with FileSystem backend for the storage driver (on)],[],[with_storage_fs=check])
> +  AC_HELP_STRING([--with-storage-fs], [with FileSystem backend for the storage driver @<:@default=check@:>@]),[],[with_storage_fs=check])
>  AC_ARG_WITH([storage-lvm],
> -[  --with-storage-lvm          with LVM backend for the storage driver (on)],[],[with_storage_lvm=check])
> +  AC_HELP_STRING([--with-storage-lvm], [with LVM backend for the storage driver @<:@default=check@:>@]),[],[with_storage_lvm=check])
>  AC_ARG_WITH([storage-iscsi],
> -[  --with-storage-iscsi        with iSCSI backend for the storage driver (on)],[],[with_storage_iscsi=check])
> +  AC_HELP_STRING([--with-storage-iscsi], [with iSCSI backend for the storage driver @<:@default=check@:>@]),[],[with_storage_iscsi=check])
>  AC_ARG_WITH([storage-scsi],
> -[  --with-storage-scsi         with SCSI backend for the storage driver (on)],[],[with_storage_scsi=check])
> +  AC_HELP_STRING([--with-storage-scsi], [with SCSI backend for the storage driver @<:@default=check@:>@]),[],[with_storage_scsi=check])
>  AC_ARG_WITH([storage-mpath],
> -[  --with-storage-mpath        with mpath backend for the storage driver (on)],[],[with_storage_mpath=check])
> +  AC_HELP_STRING([--with-storage-mpath], [with mpath backend for the storage driver @<:@default=check@:>@]),[],[with_storage_mpath=check])
>  AC_ARG_WITH([storage-disk],
> -[  --with-storage-disk         with GPartd Disk backend for the storage driver (on)],[],[with_storage_disk=check])
> +  AC_HELP_STRING([--with-storage-disk], [with GPartd Disk backend for the storage driver @<:@default=check@:>@]),[],[with_storage_disk=check])
>  
>  with_storage_dir=yes
>  if test "$with_libvirtd" = "no"; then
> @@ -1464,7 +1464,7 @@ dnl check for python
>  dnl
>  
>  AC_ARG_WITH([python],
> -[  --with-python              Build python bindings (on)],[],[with_python=yes])
> +  AC_HELP_STRING([--with-python], [Build python bindings @<:@default=yes@:>@]),[],[with_python=yes])
>  
>  if test "$enable_shared:$with_python" = no:yes; then
>    AC_MSG_WARN([Disabling shared libraries is incompatible with building Python extensions.])
> @@ -1561,7 +1561,7 @@ AC_MSG_RESULT($RUNNING_XEND)
>  AM_CONDITIONAL([ENABLE_XEN_TESTS], [test "$RUNNING_XEN" != "no" -a "$RUNNING_XEND" != "no"])
>  
>  AC_ARG_ENABLE([test-coverage],
> -[  --enable-test-coverage  turn on code coverage instrumentation],
> +  AC_HELP_STRING([--enable-test-coverage], [turn on code coverage instrumentation @<:@default=no@:>@]),
>  [case "${enableval}" in
>     yes|no) ;;
>     *)      AC_MSG_ERROR([bad value ${enableval} for test-coverage option]) ;;
> @@ -1578,7 +1578,7 @@ if test "${enable_coverage}" = yes; then
>  fi
>  
>  AC_ARG_ENABLE([test-oom],
> -[  --enable-test-oom       memory allocation failure checking],
> +  AC_HELP_STRING([--enable-test-oom], [memory allocation failure checking @<:@default=no@:>@]),
>  [case "${enableval}" in
>     yes|no) ;;
>     *)      AC_MSG_ERROR([bad value ${enableval} for test-oom option]) ;;
> @@ -1598,7 +1598,7 @@ fi
>  
>  
>  AC_ARG_ENABLE([test-locking],
> -[  --enable-test-locking       thread locking tests using CIL],
> +  AC_HELP_STRING([--enable-test-locking], [thread locking tests using CIL @<:@default=no@:>@]),
>  [case "${enableval}" in
>     yes|no) ;;
>     *)      AC_MSG_ERROR([bad value ${enableval} for test-locking option]) ;;
> @@ -1615,7 +1615,7 @@ AM_CONDITIONAL([WITH_CIL],[test "$enable_locking" = "yes"])
>  dnl Enable building the proxy?
>  
>  AC_ARG_WITH([xen-proxy],
> -[  --with-xen-proxy              add XEN setuid proxy support (on)],[],[with_xen_proxy=auto])
> +  AC_HELP_STRING([--with-xen-proxy], [add XEN setuid proxy support @<:@default=auto@:>@]),[],[with_xen_proxy=auto])
>  
>  AC_MSG_CHECKING([if Xen setuid proxy is needed])
>  if test "$with_xen_proxy" = "auto"; then
> @@ -1675,7 +1675,7 @@ AM_CONDITIONAL([WITH_WIN_ICON], [test "$WINDRES" != "no"])
>  
>  dnl Driver-Modules library
>  AC_ARG_WITH([driver-modules],
> -  [  --with-driver-modules       build drivers as loadable modules],
> +  AC_HELP_STRING([--with-driver-modules], [build drivers as loadable modules @<:@default=no@:>@]),
>    [],
>    [with_driver_modules=no])
>  
> @@ -1714,7 +1714,7 @@ dnl HAL library check for host device enumeration
>  HAL_CFLAGS=
>  HAL_LIBS=
>  AC_ARG_WITH([hal],
> -  [  --with-hal         use HAL for host device enumeration],
> +  AC_HELP_STRING([--with-hal], [use HAL for host device enumeration @<:@default=check@:>@]),
>    [],
>    [with_hal=check])
>  
> @@ -1757,7 +1757,7 @@ UDEV_LIBS=
>  PCIACCESS_CFLAGS=
>  PCIACCESS_LIBS=
>  AC_ARG_WITH([udev],
> -  [  --with-udev        use libudev for host device enumeration],
> +  AC_HELP_STRING([--with-udev], [use libudev for host device enumeration @<:@default=check@:>@]),
>    [],
>    [with_udev=check])
>  
> @@ -1809,11 +1809,11 @@ AM_CONDITIONAL([WITH_LINUX], [test `uname -s` = "Linux"])
>  
>  
>  AC_ARG_WITH([qemu-user],
> -  [  --with-qemu-user       username to run QEMU system instance as],
> +  AC_HELP_STRING([--with-qemu-user], [username to run QEMU system instance as @<:@default=root@:>@]),
>    [QEMU_USER=${withval}],
>    [QEMU_USER=root])
>  AC_ARG_WITH([qemu-group],
> -  [  --with-qemu-group      groupname to run QEMU system instance as],
> +  AC_HELP_STRING([--with-qemu-group], [groupname to run QEMU system instance as @<:@default=root@:>@]),
>    [QEMU_GROUP=${withval}],
>    [QEMU_GROUP=root])
>  AC_DEFINE_UNQUOTED([QEMU_USER], ["$QEMU_USER"], [QEMU user account])
> -- 

ACK, looks fine to me

Daniel
-- 
|: Red Hat, Engineering, London   -o-   http://people.redhat.com/berrange/ :|
|: http://libvirt.org  -o-  http://virt-manager.org  -o-  http://ovirt.org :|
|: http://autobuild.org       -o-         http://search.cpan.org/~danberr/ :|
|: GnuPG: 7D3B9505  -o-  F3C9 553F A1DA 4AC2 5648 23C1 B3DF F742 7D3B 9505 :|




More information about the libvir-list mailing list