zorba-coders team mailing list archive

["Paul J. Lucas" <960425@xxxxxxxxxxxxxxxxxx>]

Public bug reported:

The example import statement at the top of XQDoc documentation for an
XQuery module should not have the single line number of "1" -- it's
silly to have a single line numbered. For multi-line code snippets, line
numbers are OK (but really should be used only when the surrounding
documentation actually references specific line numbers). For a single-
line, it's not as obvious that the "1" is a line number since the user
can't see any other lines with increasing numbers, e.g., "2", "3", ....

** Affects: zorba
     Importance: Low
     Assignee: William Candillon (wcandillon)
         Status: New


** Tags: xqdoc

-- 
You received this bug notification because you are a member of Zorba
Coders, which is the registrant for Zorba.
https://bugs.launchpad.net/bugs/960425

Title:
  import statement in XQDoc should not have line number

Status in Zorba - The XQuery Processor:
  New

Bug description:
  The example import statement at the top of XQDoc documentation for an
  XQuery module should not have the single line number of "1" -- it's
  silly to have a single line numbered. For multi-line code snippets,
  line numbers are OK (but really should be used only when the
  surrounding documentation actually references specific line numbers).
  For a single-line, it's not as obvious that the "1" is a line number
  since the user can't see any other lines with increasing numbers,
  e.g., "2", "3", ....

To manage notifications about this bug go to:
https://bugs.launchpad.net/zorba/+bug/960425/+subscriptions