From mboxrd@z Thu Jan 1 00:00:00 1970 From: Ricardo Wurmus Subject: Re: [PATCH] Add Pandoc (and whatever it needs) Date: Thu, 10 Dec 2015 14:43:40 +0100 Message-ID: References: <874mfrl2xl.fsf@gnu.org> 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]:44464) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a71Vl-0003rt-5c for guix-devel@gnu.org; Thu, 10 Dec 2015 08:44:00 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1a71Ve-0006w1-LU for guix-devel@gnu.org; Thu, 10 Dec 2015 08:43:57 -0500 In-Reply-To: <874mfrl2xl.fsf@gnu.org> 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: Ludovic =?utf-8?Q?Court=C3=A8s?= Cc: guix-devel Ludovic Court=C3=A8s writes: >> + (home-page "https://github.com/haskell-crypto/cryptonite") >> + (synopsis "Cryptography primitives") >> + (description >> + "This package is a repository of cryptographic primitives for Ha= skell. >> +It strives to be a cryptographic kitchen sink that provides cryptogra= phy for >> +everyone. >> + >> +Supported symmetric ciphers: AES, DES, 3DES, Blowfish, Camellia, RC4,= Salsa, >> +ChaCha; supported hash functions: SHA1, SHA2, SHA3, MD2, MD4, MD5, Ke= ccak, >> +Skein, Ripemd, Tiger, Whirlpool, Blake2; MAC: HMAC, Poly1305; assymme= tric >> +crypto: DSA, RSA, DH, ECDH, ECDSA, ECC, Curve25519, Ed25519; key deri= vation >> +functions: PBKDF2, Scrypt; cryptographic random number generation: sy= stem >> +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 symmetri= c > ciphers, cryptographic hash functions, public key algorithms, key > derivation numbers, cryptographic random number generators, and more.=E2= =80=9D? I jumped over this comment as I applied the suggestions, so I updated the description in a follow-up commit. My apologies for the noise! >> + (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 an= d client. . This provides a high-level implementation of a sensitive secu= rity protocol, eliminating a common set of security issues through the us= e of the advanced type system, high level constructions and common Haskel= l features. . Currently implement the SSL3.0, TLS1.0, TLS1.1 and TLS1.2 p= rotocol, and support RSA and Ephemeral (Elliptic curve and regular) Diffi= e Hellman key exchanges, and many extensions. . Some debug tools linked w= ith tls, are available through the .") > > Could you wrap it, remove extra periods, and use @url? Ouch! This was completely untouched after importing from Hackage. I cleaned up the formatting of the package expression and also fixed the description. >> + (home-page "http://pandoc.org") >> + (synopsis "Conversion between markup formats") >> + (description >> + "Pandoc is a Haskell library for converting from one markup form= at to >> +another, and a command-line tool that uses this library. It can read= markdown >> +and (subsets of) HTML, reStructuredText, LaTeX, DocBook, MediaWiki ma= rkup, >> +TWiki markup, Haddock markup, OPML, Emacs Org-Mode, txt2tags, Word Do= cx, ODT, >> +and Textile, and it can write Markdown, reStructuredText, XHTML, HTML= 5, >> +LaTeX, ConTeXt, DocBook, OPML, OpenDocument, ODT, Word docx, RTF, Med= iaWiki, >> +DokuWiki, Textile, groff man pages, plain text, Emacs Org-Mode, Ascii= Doc, >> +Haddock markup, EPUB (v2 and v3), FictionBook2, InDesign ICML, and se= veral >> +kinds of HTML/javascript slide shows (S5, Slidy, Slideous, DZSlides, >> +reveal.js). >> + >> +Pandoc extends standard markdown syntax with footnotes, embedded LaTe= X, >> +definition lists, tables, and other features. A compatibility mode i= s >> +provided for those who need a drop-in replacement for Markdown.pl. I= n >> +contrast to existing tools for converting markdown to HTML, which use= regex >> +substitutions, pandoc has a modular design: it consists of a set of r= eaders, >> +which parse text in a given format and produce a native representatio= n of the >> +document, and a set of writers, which convert this native representat= ion into >> +a target format. Thus, adding an input or output format requires onl= y adding >> +a reader or writer.") > > Would be nice to keep just one third of it, notably by omitting the lis= t > of supported formats. :-) I shortened it substantially and pushed the modified commits. Thank you for what must have been a very tedious review! ~~ Ricardo