Docs: meaning of push-state and pop-state unclear

[matu3ba]

In lld the docs say

In the lld
.It Fl -push-state
Save the current state of
.Fl -as-needed ,
.Fl -static ,
and
.Fl -while-archive.
.It Fl -pop-state
Undo the effect of
.Fl -push-state.

In mold this has the behavior

    } else if (read_flag(args, "push-state")) {
      state.push_back({ctx.as_needed, ctx.whole_archive, ctx.is_static,
                       ctx.in_lib});
    } else if (read_flag(args, "pop-state")) {
      if (state.empty())
        Fatal(ctx) << "no state pushed before popping";
      std::tie(ctx.as_needed, ctx.whole_archive, ctx.is_static, ctx.in_lib) =
        state.back();
      state.pop_back();

For example --start-lib mentions in-archive-file,

  --start-lib                 Give following object files in-archive-file semantics
    --end-lib                 End the effect of --start-lib

and it set via ctx.in_lib = true.

1. What does in-archive-file mean? Is in-lib-file meant?
2. Do you want to add this also to lld or is this the same behavior with fine-tuned controlled?

For me to remember: The docs do not mention -- and - can be used for linker flags.