#
# These are the definitions for doc2lt and doctext MyST (Markdown) output
#

# There are some HTML tags below. These should work with Markdown, but it would
# be cleaner to use MyST-native syntax where possible.

# Note that the definition lists require the MyST "deflist" extension to be active

key                %n`%1`
synopsis           %n%1
definition         %n**%1**%n

# I want to use
#section            %n%n#### %1%n
# but it gives the warning message: WARNING: Non-consecutive header level increase; H1 to H4
# and uses H2 anyways. So we end up with huge headings that take up too much space on the page.
# Changing the first # at the top of the page to ## also doesn't help, it ALWAYS starts with H1.
# Question posted on stackoverflow but likely impossible since # is used to structure the
# document, not just as size indicator

section            %n%n## %1%n
s_synopsis         %n%n## Synopsis%n```%n
e_synopsis         %n```%n
em_dash
eof
bof
bop
eop

s_arg_list         %n%n
s_arg_inlist       - ***
e_arg_inlist       -***
s_defn_inlist      \ 
e_defn_inlist      %n
e_arg_list         %n%n

s_arg              - ***
e_arg              -***
s_defn             \ 
e_defn             %n

s_doctext_verbatim %n```none%n
e_doctext_verbatim %n```%n
s_caption          <CENTER><B>
e_caption          </B></CENTER>
picture            ![%1](%1)

end_par            %n%n
location           **Location:**<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/%1#%rq0">%1</A>%n

mantitle           # %1%n
mantitlemany       %n%n# %1%n
bofmanyend
anchor             <a name="%1"></a>