[Imported from gridengine issuezilla ​http://gridengine.sunsource.net/issues/show_bug.cgi?id=3231]

        Issue #:      3231             Platform:     All          Reporter: reuti (reuti)
       Component:     gridengine          OS:        All
     Subcomponent:    man              Version:      6.2u5alpha      CC:    None defined
        Status:       NEW              Priority:     P3
      Resolution:                     Issue type:    DEFECT
                                   Target milestone: ---
      Assigned to:    andreas (andreas)
      QA Contact:     andreas
          URL:
       * Summary:     Checkpointing: Available pseudo variables nowhere listed
   Status whiteboard:
      Attachments:

     Issue 3231 blocks:
   Votes for issue 3231:


   Opened: Tue Jan 26 07:28:00 -0700 2010 
------------------------


Applies to 6.2u5 final:

The available pseudo variables inside the checkpointing interface:

char *ckpt_variables[] = {
    "host",
    "job_owner",
    "job_id",
    "job_name",
    "queue",
    "job_pid",
    "ckpt_dir",
    "ckpt_signal",
    NULL
};

are nowhere mentioned in the man pages. They could go to `man sge_ckpt` or `man checkpoint`. I would prefer the latter.

Also the variable $SGE_CKPT_DIR and $SGE_CKPT_ENV could be mentioned there for completeness. They are on the `man qsub` page (submit.1), but
repeating them at an appropriate location would be fine though.

[Imported from gridengine issuezilla ​http://gridengine.sunsource.net/issues/show_bug.cgi?id=3234]

        Issue #:      3234             Platform:     All          Reporter: reuti (reuti)
       Component:     gridengine          OS:        All
     Subcomponent:    man              Version:      6.2u5alpha      CC:    None defined
        Status:       NEW              Priority:     P3
      Resolution:                     Issue type:    DEFECT
                                   Target milestone: ---
      Assigned to:    andreas (andreas)
      QA Contact:     andreas
          URL:
       * Summary:     man queue_conf uses spaces for indention / unusual syntax
   Status whiteboard:
      Attachments:

     Issue 3234 blocks:
   Votes for issue 3234:


   Opened: Thu Jan 28 07:21:00 -0700 2010 
------------------------


Applies to 6.2u5 final:

The new chapter for slotwise preemption uses spaces to create indentions instead of the proper "an" macros or groff commands. Although it
might be feasable when the output is presented on screen, I like to get some nice papers of some of the man pages with:

groff -man -P-pa4 /usr/sge/man/man5/queue_conf.5 > queue_conf.ps

where it starts to look strange. Other chapters show up nicely. Also the naming of variables in the form <threshold> instead of
\fIthreshold\FP gives an unusual output (the \fI will result in underlined on screen, while being italic in the postscript file).

[Imported from gridengine issuezilla ​http://gridengine.sunsource.net/issues/show_bug.cgi?id=3252]

        Issue #:      3252             Platform:     All     Reporter: reuti (reuti)
       Component:     gridengine          OS:        All
     Subcomponent:    man              Version:      6.2u5      CC:    None defined
        Status:       NEW              Priority:     P3
      Resolution:                     Issue type:    PATCH
                                   Target milestone: ---
      Assigned to:    andreas (andreas)
      QA Contact:     andreas
          URL:
       * Summary:     Wrong ' coding in qstat manpage
   Status whiteboard:
      Attachments:

     Issue 3252 blocks:
   Votes for issue 3252:


   Opened: Wed Mar 17 06:51:00 -0700 2010 
------------------------


In the qstat manpage for -explain the next line shoudl begin with:

'c'

but as ' can't be the first character in a groff line, it's implemented as \' which will be translated to a space plus a forward quote
(openSUSE 11.1) or an illegal character in Debian Lenny.

The correct implementation should be one of:

\(aq
\[cq]c'

where \[cq] stands for closing quote. The optimum would be of course to rework the complete man pages to have such notations in the usual:

\[oq]some text\[cq]

style which would also provide a nice postscript output when the man pages are being formatted through groff for it.

(There seems also to be an error in the groff_char manpage, as \` doesn't produce a right quote, but a left one.)