Re: [Libguestfs] [PATCH libnbd v2] README: Document additional packages

2023-04-17 Thread Richard W.M. Jones
On Mon, Apr 17, 2023 at 07:44:31PM +0300, Nir Soffer wrote:
> When building from git we need autoconf, automake and libtool.
> 
> Signed-off-by: Nir Soffer 
> ---
> 
> Changes sinve v1:
> - Remove `,` between package namses (Laszlo)
> 
>  README.md | 7 +++
>  1 file changed, 7 insertions(+)
> 
> diff --git a/README.md b/README.md
> index c7166613..7eed0e31 100644
> --- a/README.md
> +++ b/README.md
> @@ -32,10 +32,17 @@ ## License
>  very liberal license.
>  
>  
>  ## Building from source
>  
> +Building from source requires additional packages. On rpm based system
> +use:
> +
> +```
> +dnf install autoconf automake libtool
> +```
> +
>  To build from git:

No, if we're going to add something (which we probably should) then we
should also describe how to use 'dnf builddep' or the equivalent apt
command.  The command above seems to suggest that you'd only need to
run that 'dnf install ...' which is wrong.

I can add something to the README later if you put a note in TODO.

Rich.

-- 
Richard Jones, Virtualization Group, Red Hat http://people.redhat.com/~rjones
Read my programming and virtualization blog: http://rwmj.wordpress.com
libguestfs lets you edit virtual machines.  Supports shell scripting,
bindings from many languages.  http://libguestfs.org
___
Libguestfs mailing list
Libguestfs@redhat.com
https://listman.redhat.com/mailman/listinfo/libguestfs



Re: [Libguestfs] [PATCH libnbd v2] README: Document additional packages

2023-04-17 Thread Eric Blake
On Mon, Apr 17, 2023 at 07:29:04PM +0200, Laszlo Ersek wrote:
> >  
> >  ## Building from source
> >  
> > +Building from source requires additional packages. On rpm based system
> > +use:

Either "On an rpm based system use" or "On rpm based systems use"
sounds better

> [2]
> "Required for building from git, optional for building from tarballs:"
> 
> I *think* autoconf is only needed for the "autoreconf" step, which is
> specific to building from git; it is presumably not needed for building
> from a tarball.
> 
> I believe the same applies to automake. I've checked latest tarball
> ;
> it contains both "Makefile.am" files and "Makefile.in" files. According
> to the comments in the "Makefile.in" files, automake generates
> Makefile.in from Makefile.am, and "Makefile.in" is the input file for
> ./configure. So I think at least in theory we could technically drop the
> "Makefile.am" files from the tarball. Either way, automake should only
> be necessary when building from a git checkout, not when building from a
> tarball.
> 
> I guess (?) libtool is required in both cases though.

The intent of the GNU folks is that the three autotools (autoconf,
automake, and libtool) are developer-only (they all require perl and
GNU m4, things that aren't necessarily available on non-developer
machines), and therefore 'make dist' packages enough of their output
into the tarball that you do not have to have any of those tools
available to build the tarball.

> 
> I'm not familiar with autotools internals, so I can't say anything
> definitive here; I guess I'd propose putting autoconf and automake under
> [2], and libtool under [1]. Rich, Eric?

Libtool should also be in [2]; if it has shifted into [1], that's a
bug that should reported to the upstream libtool folks.

> 
> Again, sorry that I didn't think this through under v1 already.
> 
> Laszlo
> 

-- 
Eric Blake, Principal Software Engineer
Red Hat, Inc.   +1-919-301-3266
Virtualization:  qemu.org | libvirt.org
___
Libguestfs mailing list
Libguestfs@redhat.com
https://listman.redhat.com/mailman/listinfo/libguestfs



Re: [Libguestfs] [PATCH libnbd v2] README: Document additional packages

2023-04-17 Thread Laszlo Ersek
On 4/17/23 18:44, Nir Soffer wrote:
> When building from git we need autoconf, automake and libtool.
> 
> Signed-off-by: Nir Soffer 
> ---
> 
> Changes sinve v1:
> - Remove `,` between package namses (Laszlo)
> 
>  README.md | 7 +++
>  1 file changed, 7 insertions(+)
> 
> diff --git a/README.md b/README.md
> index c7166613..7eed0e31 100644
> --- a/README.md
> +++ b/README.md
> @@ -32,10 +32,17 @@ ## License
>  very liberal license.
>  
>  
>  ## Building from source
>  
> +Building from source requires additional packages. On rpm based system
> +use:
> +
> +```
> +dnf install autoconf automake libtool
> +```
> +
>  To build from git:
>  
>  ```
>  autoreconf -i
>  ./configure

Sorry, I'm looking at the existent context in README.md more closely
only now. I see sections such as:

[1]
"Requirements:"

and

[2]
"Required for building from git, optional for building from tarballs:"

I *think* autoconf is only needed for the "autoreconf" step, which is
specific to building from git; it is presumably not needed for building
from a tarball.

I believe the same applies to automake. I've checked latest tarball
;
it contains both "Makefile.am" files and "Makefile.in" files. According
to the comments in the "Makefile.in" files, automake generates
Makefile.in from Makefile.am, and "Makefile.in" is the input file for
./configure. So I think at least in theory we could technically drop the
"Makefile.am" files from the tarball. Either way, automake should only
be necessary when building from a git checkout, not when building from a
tarball.

I guess (?) libtool is required in both cases though.

I'm not familiar with autotools internals, so I can't say anything
definitive here; I guess I'd propose putting autoconf and automake under
[2], and libtool under [1]. Rich, Eric?

Again, sorry that I didn't think this through under v1 already.

Laszlo
___
Libguestfs mailing list
Libguestfs@redhat.com
https://listman.redhat.com/mailman/listinfo/libguestfs



[Libguestfs] [PATCH libnbd v2] README: Document additional packages

2023-04-17 Thread Nir Soffer
When building from git we need autoconf, automake and libtool.

Signed-off-by: Nir Soffer 
---

Changes sinve v1:
- Remove `,` between package namses (Laszlo)

 README.md | 7 +++
 1 file changed, 7 insertions(+)

diff --git a/README.md b/README.md
index c7166613..7eed0e31 100644
--- a/README.md
+++ b/README.md
@@ -32,10 +32,17 @@ ## License
 very liberal license.
 
 
 ## Building from source
 
+Building from source requires additional packages. On rpm based system
+use:
+
+```
+dnf install autoconf automake libtool
+```
+
 To build from git:
 
 ```
 autoreconf -i
 ./configure
-- 
2.39.2

___
Libguestfs mailing list
Libguestfs@redhat.com
https://listman.redhat.com/mailman/listinfo/libguestfs