* [Buildroot] [PATCH] docs/manual: post-image.sh/post-build.sh should use '-', not '_'
@ 2026-07-29 16:26 Robert P. J. Day
2026-08-29 21:30 ` Thomas Petazzoni via buildroot
2026-09-04 12:18 ` Thomas Perale via buildroot
0 siblings, 2 replies; 3+ messages in thread
From: Robert P. J. Day @ 2026-07-29 16:26 UTC (permalink / raw)
To: buildroot
Even though it's only documentation, the form of the names of the
post-image.sh and post-build.sh scripts should be consistent with the
names of those scripts used in the code base, using hyphen, not
underscore.
Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca>
---
I can see the chaos that is rootfs_overlay vs rootfs-overlay. Not
going near that.
diff --git a/docs/manual/customize-directory-structure.adoc b/docs/manual/customize-directory-structure.adoc
index b4b5d50e1a..aab225811b 100644
--- a/docs/manual/customize-directory-structure.adoc
+++ b/docs/manual/customize-directory-structure.adoc
@@ -23,8 +23,8 @@ to you.
| +-- linux.config
| +-- busybox.config
| +-- <other configuration files>
-| +-- post_build.sh
-| +-- post_image.sh
+| +-- post-build.sh
+| +-- post-image.sh
| +-- rootfs_overlay/
| | +-- etc/
| | +-- <some files>
@@ -84,7 +84,7 @@ layers 'common' and 'fooboard' is:
+-- board/
+-- <company>/
+-- common/
- | +-- post_build.sh
+ | +-- post-build.sh
| +-- rootfs_overlay/
| | +-- ...
| +-- patches/
@@ -94,7 +94,7 @@ layers 'common' and 'fooboard' is:
+-- linux.config
+-- busybox.config
+-- <other configuration files>
- +-- post_build.sh
+ +-- post-build.sh
+-- rootfs_overlay/
| +-- ...
+-- patches/
diff --git a/docs/manual/customize-quick-guide.adoc b/docs/manual/customize-quick-guide.adoc
index 315027c590..360cbe9622 100644
--- a/docs/manual/customize-quick-guide.adoc
+++ b/docs/manual/customize-quick-guide.adoc
@@ -35,9 +35,9 @@ your project can be skipped.
Set +BR2_ROOTFS_OVERLAY+
to +board/<manufacturer>/<boardname>/rootfs-overlay+.
. Create a post-build script
- +board/<manufacturer>/<boardname>/post_build.sh+. Set
+ +board/<manufacturer>/<boardname>/post-build.sh+. Set
+BR2_ROOTFS_POST_BUILD_SCRIPT+ to
- +board/<manufacturer>/<boardname>/post_build.sh+
+ +board/<manufacturer>/<boardname>/post-build.sh+
. If additional setuid permissions have to be set or device nodes have
to be created, create +board/<manufacturer>/<boardname>/device_table.txt+
and add that path to +BR2_ROOTFS_DEVICE_TABLE+.
diff --git a/docs/manual/customize-rootfs.adoc b/docs/manual/customize-rootfs.adoc
index 4d03d04617..b7fe5813f7 100644
--- a/docs/manual/customize-rootfs.adoc
+++ b/docs/manual/customize-rootfs.adoc
@@ -52,7 +52,7 @@ Using post-build scripts, you can remove or modify any file in your
post-build cleanup scripts.
+
As shown in xref:customize-dir-structure[], the recommended path for
- this script is +board/<company>/<boardname>/post_build.sh+.
+ this script is +board/<company>/<boardname>/post-build.sh+.
+
The post-build scripts are run with the main Buildroot tree as current
working directory. The path to the target filesystem is passed as the
_______________________________________________
buildroot mailing list
buildroot@buildroot.org
https://lists.buildroot.org/mailman/listinfo/buildroot
^ permalink raw reply related [flat|nested] 3+ messages in thread* Re: [Buildroot] [PATCH] docs/manual: post-image.sh/post-build.sh should use '-', not '_'
2026-07-29 16:26 [Buildroot] [PATCH] docs/manual: post-image.sh/post-build.sh should use '-', not '_' Robert P. J. Day
@ 2026-08-29 21:30 ` Thomas Petazzoni via buildroot
2026-09-04 12:18 ` Thomas Perale via buildroot
1 sibling, 0 replies; 3+ messages in thread
From: Thomas Petazzoni via buildroot @ 2026-08-29 21:30 UTC (permalink / raw)
To: Robert P. J. Day; +Cc: buildroot
On Wed, Jul 29, 2026 at 12:26:54PM -0400, Robert P. J. Day wrote:
>
> Even though it's only documentation, the form of the names of the
> post-image.sh and post-build.sh scripts should be consistent with the
> names of those scripts used in the code base, using hyphen, not
> underscore.
>
> Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca>
>
Applied to master, thanks!
Best regards,
Thomas Petazzoni
--
Thomas Petazzoni, co-owner and CEO, Bootlin
Embedded Linux and Kernel engineering and training
https://bootlin.com
_______________________________________________
buildroot mailing list
buildroot@buildroot.org
https://lists.buildroot.org/mailman/listinfo/buildroot
^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: [Buildroot] [PATCH] docs/manual: post-image.sh/post-build.sh should use '-', not '_'
2026-07-29 16:26 [Buildroot] [PATCH] docs/manual: post-image.sh/post-build.sh should use '-', not '_' Robert P. J. Day
2026-08-29 21:30 ` Thomas Petazzoni via buildroot
@ 2026-09-04 12:18 ` Thomas Perale via buildroot
1 sibling, 0 replies; 3+ messages in thread
From: Thomas Perale via buildroot @ 2026-09-04 12:18 UTC (permalink / raw)
To: Robert P. J. Day; +Cc: Thomas Perale, buildroot
In reply of:
> Even though it's only documentation, the form of the names of the
> post-image.sh and post-build.sh scripts should be consistent with the
> names of those scripts used in the code base, using hyphen, not
> underscore.
>
> Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca>
>
Applied to 2025.02.x & 2026.05.x. Thanks
> ---
>
> I can see the chaos that is rootfs_overlay vs rootfs-overlay. Not
> going near that.
>
> diff --git a/docs/manual/customize-directory-structure.adoc b/docs/manual/customize-directory-structure.adoc
> index b4b5d50e1a..aab225811b 100644
> --- a/docs/manual/customize-directory-structure.adoc
> +++ b/docs/manual/customize-directory-structure.adoc
> @@ -23,8 +23,8 @@ to you.
> | +-- linux.config
> | +-- busybox.config
> | +-- <other configuration files>
> -| +-- post_build.sh
> -| +-- post_image.sh
> +| +-- post-build.sh
> +| +-- post-image.sh
> | +-- rootfs_overlay/
> | | +-- etc/
> | | +-- <some files>
> @@ -84,7 +84,7 @@ layers 'common' and 'fooboard' is:
> +-- board/
> +-- <company>/
> +-- common/
> - | +-- post_build.sh
> + | +-- post-build.sh
> | +-- rootfs_overlay/
> | | +-- ...
> | +-- patches/
> @@ -94,7 +94,7 @@ layers 'common' and 'fooboard' is:
> +-- linux.config
> +-- busybox.config
> +-- <other configuration files>
> - +-- post_build.sh
> + +-- post-build.sh
> +-- rootfs_overlay/
> | +-- ...
> +-- patches/
> diff --git a/docs/manual/customize-quick-guide.adoc b/docs/manual/customize-quick-guide.adoc
> index 315027c590..360cbe9622 100644
> --- a/docs/manual/customize-quick-guide.adoc
> +++ b/docs/manual/customize-quick-guide.adoc
> @@ -35,9 +35,9 @@ your project can be skipped.
> Set +BR2_ROOTFS_OVERLAY+
> to +board/<manufacturer>/<boardname>/rootfs-overlay+.
> . Create a post-build script
> - +board/<manufacturer>/<boardname>/post_build.sh+. Set
> + +board/<manufacturer>/<boardname>/post-build.sh+. Set
> +BR2_ROOTFS_POST_BUILD_SCRIPT+ to
> - +board/<manufacturer>/<boardname>/post_build.sh+
> + +board/<manufacturer>/<boardname>/post-build.sh+
> . If additional setuid permissions have to be set or device nodes have
> to be created, create +board/<manufacturer>/<boardname>/device_table.txt+
> and add that path to +BR2_ROOTFS_DEVICE_TABLE+.
> diff --git a/docs/manual/customize-rootfs.adoc b/docs/manual/customize-rootfs.adoc
> index 4d03d04617..b7fe5813f7 100644
> --- a/docs/manual/customize-rootfs.adoc
> +++ b/docs/manual/customize-rootfs.adoc
> @@ -52,7 +52,7 @@ Using post-build scripts, you can remove or modify any file in your
> post-build cleanup scripts.
> +
> As shown in xref:customize-dir-structure[], the recommended path for
> - this script is +board/<company>/<boardname>/post_build.sh+.
> + this script is +board/<company>/<boardname>/post-build.sh+.
> +
> The post-build scripts are run with the main Buildroot tree as current
> working directory. The path to the target filesystem is passed as the
> _______________________________________________
> buildroot mailing list
> buildroot@buildroot.org
> https://lists.buildroot.org/mailman/listinfo/buildroot
_______________________________________________
buildroot mailing list
buildroot@buildroot.org
https://lists.buildroot.org/mailman/listinfo/buildroot
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2026-09-04 12:18 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2026-07-29 16:26 [Buildroot] [PATCH] docs/manual: post-image.sh/post-build.sh should use '-', not '_' Robert P. J. Day
2026-08-29 21:30 ` Thomas Petazzoni via buildroot
2026-09-04 12:18 ` Thomas Perale via buildroot
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.