GNU bug report logs - #31106
Inaccuracy in GNU parted documentation online manual

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 31106 in the body.
You can then email your comments to 31106 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Will Haley <willhy <at> gmail.com>
To: bug-parted <at> gnu.org
Subject: Inaccuracy in GNU parted documentation online manual
Date: Sun, 8 Apr 2018 23:03:08 -0500

[Message part 1 (text/plain, inline)]

https://www.gnu.org/software/parted/manual/parted.html says, regarding
`mkpart`, that a name can be specified as an argument to `mkpart`.

https://www.gnu.org/software/parted/manual/parted.html#mkpart

Command: *mkpart* *[part-type fs-type name] start end*

That does not seem to be true with the latest build of parted. At least,
not in the versions currently packaged for Ubuntu 16, Arch, or when
compiling from the git master as of 2018/04/08

The doc I referenced above states: "This document applies roughly to
version *3.2* of GNU Parted."

Unfortunately, the documented syntax does not appear to be valid.
Considering that the documentation index states the docs were last updated
in 2016, I'm assuming the syntax online is outdated.
https://www.gnu.org/software/parted/manual/

This is what I see when compiling parted from the latest souce.
https://git.savannah.gnu.org/git/parted.git

$ ./parted --version
parted (GNU parted) 3.2.94-7188

$ ./parted --help | grep -i mkpart
  mkpart PART-TYPE [FS-TYPE] START END     make a partition

Indeed, trying to specify a name for `mkpart` results in an error.

Please let me know if there is anything I can to do assist in updating this
documentation.

Thank you.

-Will

[Message part 2 (text/html, inline)]

Message #10 received at 31106-done <at> debbugs.gnu.org (full text, mbox):

From: Phil Susi <psusi <at> ubuntu.com>
To: Will Haley <willhy <at> gmail.com>, 31106-done <at> debbugs.gnu.org
Subject: Re: bug#31106: Inaccuracy in GNU parted documentation online manual
Date: Thu, 10 May 2018 13:20:11 -0400

[Message part 1 (text/plain, inline)]

The msdos partition table does not support names; use gpt for that.

On 4/9/2018 12:03 AM, Will Haley wrote:
> https://www.gnu.org/software/parted/manual/parted.html says, regarding
> `mkpart`, that a name can be specified as an argument to `mkpart`.
> 
> https://www.gnu.org/software/parted/manual/parted.html#mkpart
> 
> Command: *mkpart* *[part-type fs-type name] start end*
> 
> That does not seem to be true with the latest build of parted. At least,
> not in the versions currently packaged for Ubuntu 16, Arch, or when
> compiling from the git master as of 2018/04/08
> 
> The doc I referenced above states: "This document applies roughly to
> version *3.2* of GNU Parted."
> 
> Unfortunately, the documented syntax does not appear to be valid.
> Considering that the documentation index states the docs were last updated
> in 2016, I'm assuming the syntax online is outdated.
> https://www.gnu.org/software/parted/manual/
> 
> This is what I see when compiling parted from the latest souce.
> https://git.savannah.gnu.org/git/parted.git
> 
> $ ./parted --version
> parted (GNU parted) 3.2.94-7188
> 
> $ ./parted --help | grep -i mkpart
>   mkpart PART-TYPE [FS-TYPE] START END     make a partition
> 
> Indeed, trying to specify a name for `mkpart` results in an error.
> 
> Please let me know if there is anything I can to do assist in updating this
> documentation.
> 
> Thank you.
> 
> -Will
> 

[signature.asc (application/pgp-signature, attachment)]

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.