···

       
74
       
74
       
 
       
    apply ? null,

     

       
75
       
75
       
 
       
    # Whether the option is for NixOS developers only.

     

       
76
       
76
       
 
       
    internal ? null,

     

       
77
       
77
       
-
       
    # Whether the option shows up in the manual.

     

       
77
       
77
       
+
       
    # Whether the option shows up in the manual. Default: true. Use false to hide the option and any sub-options from submodules. Use "shallow" to hide only sub-options.

     

       
78
       
78
       
 
       
    visible ? null,

     

       
79
       
79
       
 
       
    # Whether the option can be set only once

     

       
80
       
80
       
 
       
    readOnly ? null,

     
···

       
180
       
180
       
 
       
          description = opt.description or (lib.warn "Option `${name}' has no description." "This option has no description.");

     

       
181
       
181
       
 
       
          declarations = filter (x: x != unknownModule) opt.declarations;

     

       
182
       
182
       
 
       
          internal = opt.internal or false;

     

       
183
       
183
       
-
       
          visible = opt.visible or true;

     

       
183
       
183
       
+
       
          visible =

     

       
184
       
184
       
+
       
            if (opt?visible && opt.visible == "shallow")

     

       
185
       
185
       
+
       
            then true

     

       
186
       
186
       
+
       
            else opt.visible or true;

     

       
184
       
187
       
 
       
          readOnly = opt.readOnly or false;

     

       
185
       
188
       
 
       
          type = opt.type.description or null;

     

       
186
       
189
       
 
       
        }

     
···

       
192
       
195
       
 
       
        subOptions =

     

       
193
       
196
       
 
       
          let ss = opt.type.getSubOptions opt.loc;

     

       
194
       
197
       
 
       
          in if ss != {} then optionAttrSetToDocList' opt.loc ss else [];

     

       
198
       
198
       
+
       
        subOptionsVisible = docOption.visible && opt.visible or null != "shallow";

     

       
195
       
199
       
 
       
      in

     

       
196
       
196
       
-
       
        [ docOption ] ++ optionals docOption.visible subOptions) (collect isOption options);

     

       
200
       
200
       
+
       
        [ docOption ] ++ optionals subOptionsVisible subOptions) (collect isOption options);

     

       
197
       
201
       
 
       


     

       
198
       
202
       
 
       


     

       
199
       
203
       
 
       
  /* This function recursively removes all derivation attributes from