Comments

Not logged in - Log In / Register

Launchpad Help > Comments

Launchpad Comment Parsing

This page aims to introduce the most important elements of comment's syntax on Launchpad at a glance.

Whitespaces

Launchpad will

Note: Technically Launchpad passes whitespace through and the browser just ignores the whitespace.

Examples

This   sentence  has varying     amounts  of   whitespace    between       its  words.

will look like this

This sentence has varying amounts of whitespace between its words.

Keep in mind that you have a bad time writing tables 

| Column 1   | Column 2 | Column 3    |
|------------+----------+-------------|
| Lorem      | ipsum    | dolor       |
| sit        | amet     | consectetur |
| adipiscing | elit     | sed         |

will loke like this 

| Column 1 | Column 2 | Column 3 |  
|------------+----------+-------------|  
| Lorem | ipsum | dolor |  
| sit | amet | consectetur |  
| adipiscing | elit | sed |

because any whitespace between non-whitespace characters gets reduced to just one

Paragraphs

Just like the whitespace between words. Multiple new-line characters will be reduced to one.

Example

Here are two paragraphs with lots of whitespace between them.




But they're still just two paragraphs

will look like this 

Here are two paragraphs with lots of whitespace between them.  
   
But they're still just two paragraphs

Mention a single Launchpad Bug

Synopsis

bug <LP-Bug-Number>
bug #<LP-Bug-Number>
bug number <LP-Bug-Number>
bug num <LP-Bug-Number>
bug num. <LP-Bug-Number>
bug no <LP-Bug-Number>
bug no. <LP-Bug-Number>
bug report <LP-Bug-Number>
bug-report <LP-Bug-Number>
bug-<LP-Bug-Number>
bug=<LP-Bug-Number>

Note that these patterns are case invariant.

Examples

bug 123
bug    123
bug #123
bug number 123
bug number. 123
bug num 123
bug num. 123
bug no 123
bug report 123
bug no. 123
bug#123
bug-123
bug-report-123
bug=123
debug #52

will look like this

bug 123
bug 123
bug #123
bug number 123
bug number. 123
bug num 123
bug num. 123
bug no 123
bug report 123
bug no. 123
bug#123
bug-123
bug-report-123
bug=123
debug #52

Mention multiple Launchpad Bugs

Synopsis

LP: #<LP-Bug-Number>[, #<LP-Bug-Number>]...

Note that these patterns are case invariant. The amount of whitespace can be variable, but if you place whitespace anywhere else; the regular expression might not parse the input correctly.

Examples

LP: #1
(LP: #1)
LP: #1, #2.
LP:
#1,
#2,
#3,
#4
lp: #1
(lp: #1)
lp: #1, #2.
LP #1
LP: #1 , #2
LP: #1, #2,

#3

will look like this

LP: #1
(LP: #1)
LP: #1, #2.
LP:
#1,
#2,
#3,
#4
lp: #1
(lp: #1)
lp: #1, #2.
LP #1
LP: #1 , #2
LP: #1, #2,

#3

Mention a Branch

You can link a launchpad branch by mentioning it with the lp URI syntax. lp will expand to https://bugs.launchpad.net/+code/

Synopsis

lp:<Relative-URL>
lp:/<Relative-URL>
lp:///<Relative-URL>

Note that these patterns are case invariant.

Examples

lp:~foo/bar/baz
lp:~foo/bar/bug-123
lp:~foo/+junk/baz
lp:~foo/ubuntu/jaunty/evolution/baz
lp:foo/bar
lp:foo
lp:foo,
lp:foo/bar.
lp:foo/bar/baz
lp:///foo
lp:/foo

will look like this

lp:~foo/bar/baz
lp:~foo/bar/bug-123
lp:~foo/+junk/baz
lp:~foo/ubuntu/jaunty/evolution/baz
lp:foo/bar
lp:foo
lp:foo,
lp:foo/bar.
lp:foo/bar/baz
lp:///foo
lp:///foo

Mention an FAQ Thread

You can link a launchpad FAQ thread by mentioning the number.

Synopsis

faq <faq-number>
faq #<faq-number>
faq-<faq-number>
faq=<faq-number>
faq item <faq-number>
faq number <faq-number>

Note that these patterns are case invariant.

Examples

faq 1
faq #2
faq-2
faq=2
faq item 1
faq  number  2

will look like this

faq 1
faq #2
faq-2
faq=2
faq item 1
faq number 2

URIs

Launchpad can recognize http, https, ftp, sftp, mailto, news, irc and jabber URIs.

tel, urn, telnet, ldap URIs, relative URLs like "example.com" and E-Mails like "test@example.com" are NOT recognized.

Examples

http://localhost:8086/bar/baz/foo.html
ftp://localhost:8086/bar/baz/foo.bar.html
sftp://localhost:8086/bar/baz/foo.bar.html.
http://localhost:8086/bar/baz/foo.bar.html;
news://localhost:8086/bar/baz/foo.bar.html:
http://localhost:8086/bar/baz/foo.bar.html?
http://localhost:8086/bar/baz/foo.bar.html,
<http://localhost:8086/bar/baz/foo.bar.html>
<http://localhost:8086/bar/baz/foo.bar.html>,
<http://localhost:8086/bar/baz/foo.bar.html>.
<http://localhost:8086/bar/baz/foo.bar.html>;
<http://localhost:8086/bar/baz/foo.bar.html>:
<http://localhost:8086/bar/baz/foo.bar.html>?
(http://localhost:8086/bar/baz/foo.bar.html)
(http://localhost:8086/bar/baz/foo.bar.html),
(http://localhost:8086/bar/baz/foo.bar.html).
(http://localhost:8086/bar/baz/foo.bar.html);
(http://localhost:8086/bar/baz/foo.bar.html):
http://localhost/bar/baz/foo.bar.html?a=b&b=a
http://localhost/bar/baz/foo.bar.html?a=b&b=a.
http://localhost/bar/baz/foo.bar.html?a=b&b=a,
http://localhost/bar/baz/foo.bar.html?a=b&b=a;
http://localhost/bar/baz/foo.bar.html?a=b&b=a:
http://localhost/bar/baz/foo.bar.html?a=b&b=a:b;c@d_e%f~g#h,j!k-l+m$n*o'p
http://www.searchtools.com/test/urls/(parens).html
http://www.searchtools.com/test/urls/-dash.html
http://www.searchtools.com/test/urls/_underscore.html
http://www.searchtools.com/test/urls/period.x.html
http://www.searchtools.com/test/urls/!exclamation.html
http://www.searchtools.com/test/urls/~tilde.html
http://www.searchtools.com/test/urls/*asterisk.html
irc://chat.freenode.net/launchpad
irc://chat.freenode.net/%23launchpad,isserver
mailto:noreply@launchpad.net
jabber:noreply@launchpad.net
http://localhost/foo?xxx&
http://localhost?testing=[square-brackets-in-query]

will look like this

http://localhost:8086/bar/baz/foo.html ftp://localhost:8086/bar/baz/foo.bar.html sftp://localhost:8086/bar/baz/foo.bar.html.
http://localhost:8086/bar/baz/foo.bar.html;
news://localhost:8086/bar/baz/foo.bar.html:
http://localhost:8086/bar/baz/foo.bar.html?
http://localhost:8086/bar/baz/foo.bar.html,
<http://localhost:8086/bar/baz/foo.bar.html>
<http://localhost:8086/bar/baz/foo.bar.html>,
<http://localhost:8086/bar/baz/foo.bar.html>.
<http://localhost:8086/bar/baz/foo.bar.html>;
<http://localhost:8086/bar/baz/foo.bar.html>:
<http://localhost:8086/bar/baz/foo.bar.html>?
(http://localhost:8086/bar/baz/foo.bar.html)
(http://localhost:8086/bar/baz/foo.bar.html),
(http://localhost:8086/bar/baz/foo.bar.html).
(http://localhost:8086/bar/baz/foo.bar.html);
(http://localhost:8086/bar/baz/foo.bar.html):
http://localhost/bar/baz/foo.bar.html?a=b&b=a
http://localhost/bar/baz/foo.bar.html?a=b&b=a.
http://localhost/bar/baz/foo.bar.html?a=b&b=a,
http://localhost/bar/baz/foo.bar.html?a=b&b=a;
http://localhost/bar/baz/foo.bar.html?a=b&b=a:
http://localhost/bar/baz/foo.bar.html?a=b&b=a:b;c@d_e%f~g#h,j!k-l+m$n*o'p
http://www.searchtools.com/test/urls/(parens).html
http://www.searchtools.com/test/urls/-dash.html
http://www.searchtools.com/test/urls/_underscore.html
http://www.searchtools.com/test/urls/period.x.html
http://www.searchtools.com/test/urls/!exclamation.html
http://www.searchtools.com/test/urls/~tilde.html
http://www.searchtools.com/test/urls/*asterisk.html
irc://chat.freenode.net/launchpad
irc://chat.freenode.net/%23launchpad,isserver
mailto:noreply@launchpad.net
jabber:noreply@launchpad.net
http://localhost/foo?xxx&
http://localhost?testing=[square-brackets-in-query]

Other

`"` Removal

If the entire comment is encapsulated in " like this: 

"Content"

Launchpad will remove the " 

Content

< Return to the front page

Comments (last edited 2023-04-13 13:53:02 by pelpsi)