From mboxrd@z Thu Jan 1 00:00:00 1970 From: ludo@gnu.org (Ludovic =?utf-8?Q?Court=C3=A8s?=) Subject: Re: [PATCH] Add Pandoc (and whatever it needs) Date: Wed, 09 Dec 2015 22:36:38 +0100 Message-ID: <874mfrl2xl.fsf@gnu.org> References: Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:38215) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a6mPl-0001rG-AS for guix-devel@gnu.org; Wed, 09 Dec 2015 16:36:46 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1a6mPh-0004ld-BU for guix-devel@gnu.org; Wed, 09 Dec 2015 16:36:45 -0500 In-Reply-To: (Ricardo Wurmus's message of "Fri, 27 Nov 2015 13:50:13 +0100") List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org To: Ricardo Wurmus Cc: guix-devel Ricardo Wurmus skribis: > this is the second batch of Haskell packages we need to have a Pandoc > package. These patches apply after the other patch set I sent to the ML > yesterday. Impressive (and intimidating) amount of work! I skimmed over the list of packages, which look good to me. Just a few random cosmetic comments: > + (home-page "http://github.com/snoyberg/yaml/") > + (synopsis "Support for parsing and rendering YAML documents") Maybe =E2=80=9CParsing and rendering YAML documents=E2=80=9D? > + (description > + "This library provides a wrapper to mmap, allowing files or devices= to be > +lazily loaded into memory as strict or lazy ByteStrings, ForeignPtrs or = plain > +Ptrs, using the virtual memory subsystem to do on-demand loading.") Could use @code for data types. > + (description > + "This library can load and store images in PNG, Bitmap, Jpeg, Radia= nce, > +Tiff and Gif formats.") JPEG, TIFF, GIF (all caps.) > + (home-page "http://hackage.haskell.org/package/SHA") > + (synopsis "Implementations of the SHA suite of message digest functi= ons") s/Implementations of the //g > + (home-page "https://github.com/yesodweb/wai") > + (synopsis "Basic mime-type handling types and functions") > + (description > + "This library provides basic mime-type handling types and functions= .") =E2=80=9CMIME type.=E2=80=9D > + (home-page "http://github.com/vincenthz/hs-pem") > + (synopsis "Privacy Enhanced Mail (PEM) format reader and writer.") Remove period. > + (home-page "http://github.com/vincenthz/hs-asn1-types") > + (synopsis "ASN.1 types for Haskell") > + (description > + "The packaga provides the standard types for dealing with the ASN.1 ^ Typo. > + (home-page "https://github.com/haskell-crypto/cryptonite") > + (synopsis "Cryptography primitives") > + (description > + "This package is a repository of cryptographic primitives for Haske= ll. > +It strives to be a cryptographic kitchen sink that provides cryptography= for > +everyone. > + > +Supported symmetric ciphers: AES, DES, 3DES, Blowfish, Camellia, RC4, Sa= lsa, > +ChaCha; supported hash functions: SHA1, SHA2, SHA3, MD2, MD4, MD5, Kecca= k, > +Skein, Ripemd, Tiger, Whirlpool, Blake2; MAC: HMAC, Poly1305; assymmetric > +crypto: DSA, RSA, DH, ECDH, ECDSA, ECC, Curve25519, Ed25519; key derivat= ion > +functions: PBKDF2, Scrypt; cryptographic random number generation: system > +entropy, deterministic random generator; data-related features: > +@dfn{anti-forensic information splitter} (AFIS).") What about something like =E2=80=9CIt supports a wide range of symmetric ciphers, cryptographic hash functions, public key algorithms, key derivation numbers, cryptographic random number generators, and more.=E2=80= =9D? > + (home-page "http://github.com/vincenthz/hs-tls") > + (synopsis > + "TLS/SSL protocol native implementation (Server and Client)") > + (description > + "Native Haskell TLS and SSL protocol implementation for server and c= lient. . This provides a high-level implementation of a sensitive security = protocol, eliminating a common set of security issues through the use of th= e advanced type system, high level constructions and common Haskell feature= s. . Currently implement the SSL3.0, TLS1.0, TLS1.1 and TLS1.2 protocol, an= d support RSA and Ephemeral (Elliptic curve and regular) Diffie Hellman key= exchanges, and many extensions. . Some debug tools linked with tls, are av= ailable through the .") Could you wrap it, remove extra periods, and use @url? > + (home-page "http://pandoc.org") > + (synopsis "Conversion between markup formats") > + (description > + "Pandoc is a Haskell library for converting from one markup format = to > +another, and a command-line tool that uses this library. It can read ma= rkdown > +and (subsets of) HTML, reStructuredText, LaTeX, DocBook, MediaWiki marku= p, > +TWiki markup, Haddock markup, OPML, Emacs Org-Mode, txt2tags, Word Docx,= ODT, > +and Textile, and it can write Markdown, reStructuredText, XHTML, HTML 5, > +LaTeX, ConTeXt, DocBook, OPML, OpenDocument, ODT, Word docx, RTF, MediaW= iki, > +DokuWiki, Textile, groff man pages, plain text, Emacs Org-Mode, AsciiDoc, > +Haddock markup, EPUB (v2 and v3), FictionBook2, InDesign ICML, and sever= al > +kinds of HTML/javascript slide shows (S5, Slidy, Slideous, DZSlides, > +reveal.js). > + > +Pandoc extends standard markdown syntax with footnotes, embedded LaTeX, > +definition lists, tables, and other features. A compatibility mode is > +provided for those who need a drop-in replacement for Markdown.pl. In > +contrast to existing tools for converting markdown to HTML, which use re= gex > +substitutions, pandoc has a modular design: it consists of a set of read= ers, > +which parse text in a given format and produce a native representation o= f the > +document, and a set of writers, which convert this native representation= into > +a target format. Thus, adding an input or output format requires only a= dding > +a reader or writer.") Would be nice to keep just one third of it, notably by omitting the list of supported formats. :-) I think it=E2=80=99s OK to commit with these changes. I hope it=E2=80=99s = not too painful to apply them. Thank you! Ludo=E2=80=99.