annotate docs/man/man8/ftjail-populate-tmpl.rst @ 808:ab21dd56f99e

fports: Implement "fports detail -A" as a shortcut to "-b -n -m". While there fixed some "program" usage in the manpage. Also rename a bogus "options" directive to "option".
author Franz Glasner <fzglas.hg@dom66.de>
date Tue, 05 Nov 2024 11:57:34 +0100
parents dee8e2611f71
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
297
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
1 .. -*- coding: utf-8; indent-tabs-mode: nil; -*-
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
2
307
23bcbbbd99ea FIX: Rename "ftjail-populate.rst" to "ftjail-populate-tmpl"
Franz Glasner <fzglas.hg@dom66.de>
parents: 297
diff changeset
3 ftjail-populate-tmpl
23bcbbbd99ea FIX: Rename "ftjail-populate.rst" to "ftjail-populate-tmpl"
Franz Glasner <fzglas.hg@dom66.de>
parents: 297
diff changeset
4 ====================
297
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
5
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
6 Synopsis
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
7 --------
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
8
456
1aa75c6d3ef6 FIX: man pages are now in $PREFIX/share/man instead of $PREFIX/man
Franz Glasner <fzglas.hg@dom66.de>
parents: 307
diff changeset
9 **ftjail populate-tmpl** [**-b**] **-L** `directory` `path/to/base.txz` [`path/to/kernel.txz`]
297
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
10
456
1aa75c6d3ef6 FIX: man pages are now in $PREFIX/share/man instead of $PREFIX/man
Franz Glasner <fzglas.hg@dom66.de>
parents: 307
diff changeset
11 **ftjail populate-tmpl** [**-b**] **-P** `directory` `path/to/base.txz` [`path/to/kernel.txz`]
297
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
12
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
13
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
14 Description
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
15 -----------
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
16
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
17 Populate the directory in `directory` with a FreeBSD base system.
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
18 The base system's archive ist in `path/to/base.txz`.
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
19
456
1aa75c6d3ef6 FIX: man pages are now in $PREFIX/share/man instead of $PREFIX/man
Franz Glasner <fzglas.hg@dom66.de>
parents: 307
diff changeset
20 Optionally a FreeBSD kernel can be extracted also.
1aa75c6d3ef6 FIX: man pages are now in $PREFIX/share/man instead of $PREFIX/man
Franz Glasner <fzglas.hg@dom66.de>
parents: 307
diff changeset
21
297
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
22 The directory in `directory` must already have a proper
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
23 directory layout.
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
24 This can be accomplished by :manpage:`ftjail-mount-tmpl(8)`.
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
25
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
26 Apply knowledge of the type and typical layout of the RW skeleton
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
27 (e.g. handle the :file:`skeleton` symlink properly).
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
28
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
29
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
30 Options
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
31 -------
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
32
307
23bcbbbd99ea FIX: Rename "ftjail-populate.rst" to "ftjail-populate-tmpl"
Franz Glasner <fzglas.hg@dom66.de>
parents: 297
diff changeset
33 .. program:: ftjail populate-tmpl
297
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
34
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
35 .. option:: -L
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
36
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
37 Copy dataset properties optimized for employing a :file:`skeleton`
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
38 subdirectory.
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
39
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
40 .. option:: -P
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
41
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
42 Copy dataset properties optimized for direct mounts of skeleton
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
43 children over an already mounted base.
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
44
456
1aa75c6d3ef6 FIX: man pages are now in $PREFIX/share/man instead of $PREFIX/man
Franz Glasner <fzglas.hg@dom66.de>
parents: 307
diff changeset
45 .. option:: -b
1aa75c6d3ef6 FIX: man pages are now in $PREFIX/share/man instead of $PREFIX/man
Franz Glasner <fzglas.hg@dom66.de>
parents: 307
diff changeset
46
457
dee8e2611f71 Man: Wording
Franz Glasner <fzglas.hg@dom66.de>
parents: 456
diff changeset
47 Do not empty the ``/boot`` folder in `directory` but preserve it.
456
1aa75c6d3ef6 FIX: man pages are now in $PREFIX/share/man instead of $PREFIX/man
Franz Glasner <fzglas.hg@dom66.de>
parents: 307
diff changeset
48 This option is implied if a `path/to/kernel.txz` is given.
1aa75c6d3ef6 FIX: man pages are now in $PREFIX/share/man instead of $PREFIX/man
Franz Glasner <fzglas.hg@dom66.de>
parents: 307
diff changeset
49
297
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
50
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
51 See Also
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
52 --------
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
53
a452ace0175a Manual page for "ftjail populate"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
54 :manpage:`ftjail(8)`, :manpage:`ftjail-mount-tmpl(8)`