···

       
17
       
 
       
      )

     

       
18
       
 
       
      output

     

       
19
       
 
       
  );

     

       
0
       
 
       

     

       
0
       
 
       

     

       
20
       
 
       
in

     

       
21
       
 
       
{

     

       
22
       
 
       
  meta.maintainers = [ lib.maintainers.sternenseemann ];

     
···

       
29
       
 
       
        type = with lib.types; listOf str;

     

       
30
       
 
       
        default = [ "share/man" ];

     

       
31
       
 
       
        example = lib.literalExpression "[ \"share/man\" \"share/man/fr\" ]";

     

       
0
       
 
       

     

       
32
       
 
       
        description = ''

     

       
33
       
 
       
          Change the paths included in the MANPATH environment variable,

     

       
34
       
 
       
          i. e. the directories where {manpage}`man(1)`

     
···

       
46
       
 
       
        default = cfg.manPath;

     

       
47
       
 
       
        defaultText = lib.literalExpression "config.documentation.man.mandoc.manPath";

     

       
48
       
 
       
        example = lib.literalExpression "[ \"share/man\" \"share/man/fr\" ]";

     

       
0
       
 
       

     

       
49
       
 
       
        description = ''

     

       
50
       
 
       
          Change the paths where mandoc {manpage}`makewhatis(8)`generates the

     

       
51
       
 
       
          manual page index caches. {option}`documentation.man.generateCaches`

     
···

       
199
       
 
       
      # TODO(@sternenseemman): fix symlinked directories not getting indexed,

     

       
200
       
 
       
      # see: https://inbox.vuxu.org/mandoc-tech/20210906171231.GF83680@athene.usta.de/T/#e85f773c1781e3fef85562b2794f9cad7b2909a3c

     

       
201
       
 
       
      extraSetup = lib.mkIf config.documentation.man.generateCaches ''

     

       
202
       
-
       
        for man_path in ${lib.concatMapStringsSep " " (path: "$out/" + lib.escapeShellArg path) cfg.cachePath}

     

       
203
       
 
       
        do

     

       
204
       
 
       
          [[ -d "$man_path" ]] && ${makewhatis} -T utf8 $man_path

     

       
205
       
 
       
        done

     

       
206
       
 
       
      '';

     

       
207
       
 
       


     

       
208
       
 
       
      # tell mandoc the paths containing man pages

     

       
209
       
-
       
      profileRelativeSessionVariables."MANPATH" = map (path: if builtins.substring 0 1 path != "/" then "/${path}" else path) cfg.manPath;

     

       
210
       
 
       
    };

     

       
211
       
 
       
  };

     

       
212
       
 
       
}

     

···

       
17
       
 
       
      )

     

       
18
       
 
       
      output

     

       
19
       
 
       
  );

     

       
20
       
+
       


     

       
21
       
+
       
  makeLeadingSlashes = map (path: if builtins.substring 0 1 path != "/" then "/${path}" else path);

     

       
22
       
 
       
in

     

       
23
       
 
       
{

     

       
24
       
 
       
  meta.maintainers = [ lib.maintainers.sternenseemann ];

     
···

       
31
       
 
       
        type = with lib.types; listOf str;

     

       
32
       
 
       
        default = [ "share/man" ];

     

       
33
       
 
       
        example = lib.literalExpression "[ \"share/man\" \"share/man/fr\" ]";

     

       
34
       
+
       
        apply = makeLeadingSlashes;

     

       
35
       
 
       
        description = ''

     

       
36
       
 
       
          Change the paths included in the MANPATH environment variable,

     

       
37
       
 
       
          i. e. the directories where {manpage}`man(1)`

     
···

       
49
       
 
       
        default = cfg.manPath;

     

       
50
       
 
       
        defaultText = lib.literalExpression "config.documentation.man.mandoc.manPath";

     

       
51
       
 
       
        example = lib.literalExpression "[ \"share/man\" \"share/man/fr\" ]";

     

       
52
       
+
       
        apply = makeLeadingSlashes;

     

       
53
       
 
       
        description = ''

     

       
54
       
 
       
          Change the paths where mandoc {manpage}`makewhatis(8)`generates the

     

       
55
       
 
       
          manual page index caches. {option}`documentation.man.generateCaches`

     
···

       
203
       
 
       
      # TODO(@sternenseemman): fix symlinked directories not getting indexed,

     

       
204
       
 
       
      # see: https://inbox.vuxu.org/mandoc-tech/20210906171231.GF83680@athene.usta.de/T/#e85f773c1781e3fef85562b2794f9cad7b2909a3c

     

       
205
       
 
       
      extraSetup = lib.mkIf config.documentation.man.generateCaches ''

     

       
206
       
+
       
        for man_path in ${lib.concatMapStringsSep " " (path: "$out" + lib.escapeShellArg path) cfg.cachePath}

     

       
207
       
 
       
        do

     

       
208
       
 
       
          [[ -d "$man_path" ]] && ${makewhatis} -T utf8 $man_path

     

       
209
       
 
       
        done

     

       
210
       
 
       
      '';

     

       
211
       
 
       


     

       
212
       
 
       
      # tell mandoc the paths containing man pages

     

       
213
       
+
       
      profileRelativeSessionVariables."MANPATH" = lib.mkIf (cfg.manPath != [ ]) cfg.manPath;

     

       
214
       
 
       
    };

     

       
215
       
 
       
  };

     

       
216
       
 
       
}