dm_roff_to_pdf Function

public function dm_roff_to_pdf(roff, path, macro, pic, preconv, tbl) result(rc)

Passes the markup string roff to groff(1) to create a PDF file that is written to path. An existing file will not be replaced. On error, an empty file may still be created. By default, this function uses macro package ms, unless argument macro is passed.

The function returns the following error codes:

• E_ERROR if execution of groff(1) failed.
• E_EXIST if output file at path exists.
• E_INVALID if macro is invalid.
• E_IO if output file could not be created.
• E_SYSTEM if system call failed.
• E_WRITE if writing failed.

Arguments

Type	Intent	Optional	Attributes		Name
character(len=*),	intent(inout)			::	roff	Markup string.
character(len=*),	intent(in)			::	path	Path of output file.
integer,	intent(in),	optional		::	macro	Macro package to use (ROFF_MACRO_*).
logical,	intent(in),	optional		::	pic	Run pic preprocessor.
logical,	intent(in),	optional		::	preconv	Run preconv preprocessor.
logical,	intent(in),	optional		::	tbl	Run tbl preprocessor.

Return Value integer