bug#55688: Incorrect documentation of "string-pad"

bug#55688: Incorrect documentation of "string-pad"

[emacs--- via Bug reports for GNU Emacs, the Swiss army knife of text editors]

Documentation of "string-pad" function says following (highlighting is
mine).

	@defun string-pad string length &optional padding start

	Pad @var{string} to the be of @var{length} using @var{padding} as the
	padding character (defaulting to the space character).

	If @var{string} is shorter than @var{length}, no padding is done.
	^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

	If @var{start} is @code{nil} (or not present), the padding is done to the
	end of the string, and if it's non-@code{nil}, to the start of the
	string.

=> https://git.savannah.gnu.org/cgit/emacs.git/tree/doc/lispref/strings.texi#n445

I don't think highlighted line is correct. I matches neither behaviour of
emacs:

	=> (string-pad "foo" 12)
	"foo         "

nor what is usually meant by word "padding". I believe issue can be
solved by s/shorter/longer or removing highlighted line at all.

bug#55688: Incorrect documentation of "string-pad"

[Eli Zaretskii]

> Resent-From: emacs@kaction.cc
> Original-Sender: "Debbugs-submit" <debbugs-submit-bounces@debbugs.gnu.org>
> Resent-CC: bug-gnu-emacs@gnu.org
> Resent-Sender: help-debbugs@gnu.org
> Cc: self@kaction.cc
> Date: Fri, 27 May 2022 18:13:53 -0400
> From: emacs--- via "Bug reports for GNU Emacs,
>  the Swiss army knife of text editors" <bug-gnu-emacs@gnu.org>
> 
> Documentation of "string-pad" function says following (highlighting is
> mine).
> 
> 	@defun string-pad string length &optional padding start
> 
> 	Pad @var{string} to the be of @var{length} using @var{padding} as the
> 	padding character (defaulting to the space character).
> 
> 	If @var{string} is shorter than @var{length}, no padding is done.
> 	^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> 
> 	If @var{start} is @code{nil} (or not present), the padding is done to the
> 	end of the string, and if it's non-@code{nil}, to the start of the
> 	string.
> 
> => https://git.savannah.gnu.org/cgit/emacs.git/tree/doc/lispref/strings.texi#n445
> 
> I don't think highlighted line is correct. I matches neither behaviour of
> emacs:
> 
> 	=> (string-pad "foo" 12)
> 	"foo         "
> 
> nor what is usually meant by word "padding". I believe issue can be
> solved by s/shorter/longer or removing highlighted line at all.

It was more than that.  Now fixed on the release branch.

Thanks.