doc/src/rtd/gen_title.im

   1 .** vim: ts=4 sw=4 noet:
   2 .if false
   3 ==================================================================================
   4         Copyright (c) 2020 Nokia
   5         Copyright (c) 2020 AT&T Intellectual Property.
   6
   7    Licensed under the Apache License, Version 2.0 (the "License");
   8    you may not use this file except in compliance with the License.
   9    You may obtain a copy of the License at
  10
  11        http://www.apache.org/licenses/LICENSE-2.0
  12
  13    Unless required by applicable law or agreed to in writing, software
  14    distributed under the License is distributed on an "AS IS" BASIS,
  15    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  16    See the License for the specific language governing permissions and
  17    limitations under the License.
  18 ==================================================================================
  19 .fi
  20
  21 .if false
  22         Mnemonic:       gen_title.im
  23         Abstract:       Imbed file to generate a title when requested.  Uses doc_title and
  24                                 doc_subtitle strings if available. We will inject a man page title
  25                                 if the INPUT_FILE env variable is set to avoid having to edit
  26                                 all of them to add such a beast which isn't needed for a real
  27                                 man page.
  28
  29         Date:           10 April 2020
  30 .fi
  31
  32 .gv e INPUT_FILE in
  33 .if in
  34         .if ! doc_title
  35                 .dv doc_title Man Page: &in
  36         .fi
  37 .fi
  38
  39 .im license.im
  40
  41 .gv e OUTPUT_TYPE ot
  42 .if doc_title
  43         .if "&ot" "rst" =
  44                 &many_equals .br
  45                 &doc_title .br
  46                 &many_equals .br
  47                 .if &doc_subtitle
  48                         &many_dashes .br
  49                         &doc_subtitle .br
  50                         &many_dashes .br
  51                 .fi
  52         .ei
  53                 .sf Helvetica
  54                 .sp 5
  55                 .st 18
  56                 .ce &doc_title
  57                 .st 12
  58                 .if &doc_subtitle
  59                         .ce &doc_subtitle
  60                 .fi
  61                 .st &textsize
  62                 .sf &txtfont
  63                 .sp 2
  64         .fi
  65 .fi