Your message dated Thu, 2 Jan 2025 22:52:35 +0000
with message-id
<cagc9rjqxu8hl9xgvssd5bq7fmtsjka0frerbgcs_sovd2fd...@mail.gmail.com>
and subject line Closing Bug #700215: Documentation in Markdown Format
has caused the Debian Bug report #700215,
regarding Documentation is not converted to common documentation formats
to be marked as done.
This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.
(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact [email protected]
immediately.)
--
700215: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=700215
Debian Bug Tracking System
Contact [email protected] with problems
--- Begin Message ---
Package: httpie
Version: 0.3.1-1
Severity: important
This package has a file called /usr/share/doc/httpie/README.rst.gz .
Actually it is plain text written in syntax of reStructuredText:
http://docutils.sourceforge.net/
http://docutils.sourceforge.net/rst.html
http://en.wikipedia.org/wiki/ReStructuredText
It is quite human readable, because it is so called lightweight markup
language:
http://en.wikipedia.org/wiki/Lightweight_markup_language
But it is really meant to be converted to other formats, especially
HTML and PDF (via LaTeX). Here is my very huge example of converting
reStructuredText to umpteen gazillion formats:
http://iki.fi/juhtolv/tolleharj/
-- System Information:
Debian Release: 7.0
APT prefers stable
APT policy: (990, 'stable'), (500, 'testing-proposed-updates'), (500,
'stable-updates'), (500, 'proposed-updates'), (102, 'testing'), (101,
'unstable')
Architecture: i386 (i686)
Kernel: Linux 3.2.0-4-686-pae (SMP w/1 CPU core)
Locale: LANG=fi_FI.utf8, LC_CTYPE=fi_FI.utf8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Versions of packages httpie depends on:
ii python 2.7.3-3
ii python-argparse 1.2.1-2
ii python-pygments 1.6+dfsg-1
ii python-requests 0.12.1-1
ii python2.7 [python-argparse] 2.7.3-6
httpie recommends no packages.
httpie suggests no packages.
-- no debconf information
--
Juhapekka "naula" Tolvanen * http colon slash slash iki dot fi slash juhtolv
"Quidquid Latine dictum sit altum videtur."
--- End Message ---
--- Begin Message ---
Thank you for bringing this issue to our attention.
After reviewing the latest version of the httpie package, it is evident
that the upstream is no longer providing documentation in ReStructuredText
format. Instead, they have opted for Markdown, which is widely accepted and
readable.
Given that Markdown meets the necessary criteria for documentation
readability and usability, I consider this issue resolved.
The current documentation format is sufficient for the package's needs, and
no further action will be taken regarding converting or replacing it with
HTML or PDF.
For reference, you can find the list of files from the latest version of
the package here:
https://packages.debian.org/sid/all/httpie/filelist
Please let me know if there’s anything else you’d like to discuss regarding
this matter.
Best regards,
Arthur Diniz
--- End Message ---
