git: b063ea64c72e - main - mkimg.1: Document new %align mechanism

The branch main has been updated by cperciva:

URL: https://cgit.FreeBSD.org/src/commit/?id=b063ea64c72e075f593d0429739881df304ccd56

commit b063ea64c72e075f593d0429739881df304ccd56
Author:     Colin Percival <cperciva@FreeBSD.org>
AuthorDate: 2026-10-07 21:55:47 +0000
Commit:     Colin Percival <cperciva@FreeBSD.org>
CommitDate: 2026-10-21 20:40:37 +0000

    mkimg.1: Document new %align mechanism
    
    Reviewed by:    imp (earlier version)
    MFC after:      1 week
    Sponsored by:   Amazon
    Differential Revision:  https://reviews.freebsd.org/D60451
---
 usr.bin/mkimg/mkimg.1 | 24 +++++++++++++++++++++---
 1 file changed, 21 insertions(+), 3 deletions(-)

diff --git a/usr.bin/mkimg/mkimg.1 b/usr.bin/mkimg/mkimg.1
index 10cf413188e6..d1feb78518d9 100644
--- a/usr.bin/mkimg/mkimg.1
+++ b/usr.bin/mkimg/mkimg.1
@@ -22,7 +22,7 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd September 29, 2026
+.Dd October 21, 2026
 .Dt MKIMG 1
 .Os
 .Sh NAME
@@ -316,8 +316,8 @@ may be used multiple times to specify a list of created partition entries.
 A specification that is a single dash indicates an unused partition entry.
 Otherwise, a partition specification has the following format:
 .Bd -literal -offset indent
-<type>[/<label>]::<size>[:[+]<offset>]
-<type>[/<label>]:=<file>[:[+]<offset>]
+<type>[/<label>]::<size>[:[+]<offset>][%<align>]
+<type>[/<label>]:=<file>[:[+]<offset>][%<align>]
 <type>[/<label>]:-<cmd>
 -
 .Ed
@@ -351,6 +351,24 @@ it is relative to the end of the previous partition; otherwise it is an
 absolute offset from the start of the image.
 The value follows the same numeric conventions as
 .Cm size .
+.It Cm align
+an optional alignment for the
+.Cm size
+and
+.Cm file
+forms.
+It is an error to specify an absolute
+.Cm offset
+which is not a multiple of
+.Cm align .
+When a relative
+.Cm offset
+is specified in combination with
+.Cm align ,
+the offset is applied first and then additional padding is added to reach the
+requested alignment.
+The value follows the same numeric conventions as
+.Cm size .
 .It Cm -
 an unused partition entry.
 .El