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 IntentOptional 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


Calls

proc~~dm_roff_to_pdf~~CallsGraph proc~dm_roff_to_pdf dm_roff_to_pdf interface~dm_present dm_present proc~dm_roff_to_pdf->interface~dm_present proc~dm_file_touch dm_file_touch proc~dm_roff_to_pdf->proc~dm_file_touch proc~dm_is_error dm_is_error proc~dm_roff_to_pdf->proc~dm_is_error proc~dm_is_ok dm_is_ok proc~dm_roff_to_pdf->proc~dm_is_ok proc~dm_pipe_close dm_pipe_close proc~dm_roff_to_pdf->proc~dm_pipe_close proc~dm_pipe_open dm_pipe_open proc~dm_roff_to_pdf->proc~dm_pipe_open proc~dm_pipe_write dm_pipe_write proc~dm_roff_to_pdf->proc~dm_pipe_write proc~dm_roff_device_is_valid dm_roff_device_is_valid proc~dm_roff_to_pdf->proc~dm_roff_device_is_valid proc~dm_roff_macro_is_valid dm_roff_macro_is_valid proc~dm_roff_to_pdf->proc~dm_roff_macro_is_valid proc~dm_string_append dm_string_append proc~dm_roff_to_pdf->proc~dm_string_append c_pclose c_pclose proc~dm_pipe_close->c_pclose proc~dm_pipe_is_connected dm_pipe_is_connected proc~dm_pipe_close->proc~dm_pipe_is_connected c_popen c_popen proc~dm_pipe_open->c_popen proc~dm_f_c_string dm_f_c_string proc~dm_pipe_open->proc~dm_f_c_string proc~dm_pipe_open->proc~dm_pipe_is_connected proc~dm_pipe_write->interface~dm_present c_fputs c_fputs proc~dm_pipe_write->c_fputs proc~dm_pipe_write->proc~dm_pipe_is_connected