diff options
Diffstat (limited to 'bmake.cat1')
| -rw-r--r-- | bmake.cat1 | 68 |
1 files changed, 37 insertions, 31 deletions
diff --git a/bmake.cat1 b/bmake.cat1 index baaad7b4ed70..ecfa7cbadf9a 100644 --- a/bmake.cat1 +++ b/bmake.cat1 @@ -7,7 +7,7 @@ SSYYNNOOPPSSIISS bbmmaakkee [--BBeeiikkNNnnqqrrSSssttWWwwXX] [--CC _d_i_r_e_c_t_o_r_y] [--DD _v_a_r_i_a_b_l_e] [--dd _f_l_a_g_s] [--ff _m_a_k_e_f_i_l_e] [--II _d_i_r_e_c_t_o_r_y] [--JJ _p_r_i_v_a_t_e] [--jj _m_a_x___j_o_b_s] [--mm _d_i_r_e_c_t_o_r_y] [--TT _f_i_l_e] [--VV _v_a_r_i_a_b_l_e] [--vv _v_a_r_i_a_b_l_e] - [_v_a_r_i_a_b_l_e==_v_a_l_u_e] [_t_a_r_g_e_t ...] + [_v_a_r_i_a_b_l_e==_v_a_l_u_e ...] [_t_a_r_g_e_t ...] DDEESSCCRRIIPPTTIIOONN bbmmaakkee is a program designed to simplify the maintenance of other @@ -1073,40 +1073,46 @@ VVAARRIIAABBLLEE AASSSSIIGGNNMMEENNTTSS ::ttww Causes the value to be treated as a list of words. See also `::[[@@]]'. - ::SS/_o_l_d___s_t_r_i_n_g/_n_e_w___s_t_r_i_n_g/[11ggWW] + ::SS/[^^]_o_l_d___s_t_r_i_n_g[$$]/_n_e_w___s_t_r_i_n_g/[11ggWW] Modifies the first occurrence of _o_l_d___s_t_r_i_n_g in each word of the - value, replacing it with _n_e_w___s_t_r_i_n_g. If a `g' is appended to the - last delimiter of the pattern, all occurrences in each word are - replaced. If a `1' is appended to the last delimiter of the - pattern, only the first occurrence is affected. If a `W' is - appended to the last delimiter of the pattern, the value is treated - as a single word. If _o_l_d___s_t_r_i_n_g begins with a caret (`^'), - _o_l_d___s_t_r_i_n_g is anchored at the beginning of each word. If _o_l_d___s_t_r_i_n_g - ends with a dollar sign (`$'), it is anchored at the end of each - word. Inside _n_e_w___s_t_r_i_n_g, an ampersand (`&') is replaced by - _o_l_d___s_t_r_i_n_g (without the anchoring `^' or `$'). Any character may be - used as the delimiter for the parts of the modifier string. The - anchoring, ampersand and delimiter characters can be escaped with a - backslash (`\'). + value, replacing it with _n_e_w___s_t_r_i_n_g. - Both _o_l_d___s_t_r_i_n_g and _n_e_w___s_t_r_i_n_g may contain nested expressions. To - prevent a dollar sign from starting a nested expression, escape it - with a backslash. + If _o_l_d___s_t_r_i_n_g is preceded by a caret (`^'), _o_l_d___s_t_r_i_n_g is anchored + at the beginning of each word. If _o_l_d___s_t_r_i_n_g is followed by a + dollar sign (`$'), it is anchored at the end of each word. Inside + _n_e_w___s_t_r_i_n_g, an ampersand (`&') is replaced by _o_l_d___s_t_r_i_n_g. Both + _o_l_d___s_t_r_i_n_g and _n_e_w___s_t_r_i_n_g may contain nested expressions. + + Further options: + + 11 Only the word of the first occurrence is affected. + + gg All occurrences in each affected word are replaced. + + WW The expression value is treated as a single word. + + Any character may be used as the delimiter for the parts of the + modifier string. The anchoring, ampersand, dollar and delimiter + characters can be escaped with a backslash (`\'). ::CC/_p_a_t_t_e_r_n/_r_e_p_l_a_c_e_m_e_n_t/[11ggWW] - The ::CC modifier works like the ::SS modifier except that the old and - new strings, instead of being simple strings, are an extended - regular expression _p_a_t_t_e_r_n (see regex(3)) and an ed(1)-style - _r_e_p_l_a_c_e_m_e_n_t. Normally, the first occurrence of the pattern _p_a_t_t_e_r_n - in each word of the value is substituted with _r_e_p_l_a_c_e_m_e_n_t. The `1' - modifier causes the substitution to apply to at most one word; the - `g' modifier causes the substitution to apply to as many instances - of the search pattern _p_a_t_t_e_r_n as occur in the word or words it is - found in; the `W' modifier causes the value to be treated as a - single word (possibly containing embedded whitespace). + Modifies the first occurrence of the extended regular expression + _p_a_t_t_e_r_n (see regex(3)) in each word of the value, replacing it with + an ed(1)-style _r_e_p_l_a_c_e_m_e_n_t. + + Both _p_a_t_t_e_r_n and _r_e_p_l_a_c_e_m_e_n_t may contain nested expressions. + + Further options: + + 11 Only the word of the first occurrence is affected. + + gg All occurrences in each affected word are replaced. + + WW The expression value is treated as a single word. - As for the ::SS modifier, the _p_a_t_t_e_r_n and _r_e_p_l_a_c_e_m_e_n_t are subjected to - variable expansion before being parsed as regular expressions. + Any character may be used as the delimiter for the parts of the + modifier string. The anchoring, ampersand, dollar and delimiter + characters can be escaped with a backslash (`\'). ::TT Replaces each word with its last path component (basename). @@ -1874,4 +1880,4 @@ BBUUGGSS attempt to suppress a cascade of unnecessary errors, can result in a seemingly unexplained `*** Error code 6' -FreeBSD 14.3-RELEASE-p3 November 11, 2025 FreeBSD 14.3-RELEASE-p3 +FreeBSD 14.3-RELEASE-p9 February 8, 2026 FreeBSD 14.3-RELEASE-p9 |