Ubuntu – Quickly, setup.py, long_description – how to make them generate a multi-paragraph description in the debian control file?


Possible Duplicate:
How to define multiline long_description in quickly's setup.py?

How can I make Quickly convert the long_description in setup.py into several paragraphs in the debian control file?

Quickly throws the error below if I put "\n" in the text, and every other way I try just leads to one long one-paragraph description (i.e. everything concatenated in a single paragraph).

Generally – can we use any type of markup – bullets, etc.? I see some entries in USC that use bullets in the description, so it must be possible.

Traceback (most recent call last):
  File "/usr/bin/python-mkdebian", line 366, in <module>
    egg = get_egg_info()
  File "/usr/bin/python-mkdebian", line 35, in get_egg_info
    k, v = l.strip().split(': ', 1)
ValueError: need more than 1 value to unpack

Best Answer

  • The descriptions you see in the software center, are not from the setup.py (or other similar files), for the application. Those are defined in the packaging itself, which is on the server.

    In the debian/control file, you need to separate each paragraph with a line which contains only a period at the beginning, and every line except the leading one-line summary, must have a single space at the beginning.

    You should use the standard multi-line string formatting of Python for the long_description in setup.py, and should simply have a blank line between paragraphs there. If you're using multiple string literals, rather than the triple-quote literals, you should have an empty string for the blank lines to separate the paragraphs.

  • Related Question