Re: [Tools-discuss] New tool: Using Emacs Org Mode for writing RFCs

Richard Barnes <richard.barnes@gmail.com> Tue, 05 March 2019 03:24 UTC

Return-Path: <richard.barnes@gmail.com>
X-Original-To: tools-discuss@ietfa.amsl.com
Delivered-To: tools-discuss@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id A99B2130EE0 for <tools-discuss@ietfa.amsl.com>; Mon, 4 Mar 2019 19:24:51 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.998
X-Spam-Level:
X-Spam-Status: No, score=-1.998 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, FREEMAIL_FROM=0.001, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=gmail.com
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id LfcVHJ3cOxgB for <tools-discuss@ietfa.amsl.com>; Mon, 4 Mar 2019 19:24:48 -0800 (PST)
Received: from mail-qt1-x82a.google.com (mail-qt1-x82a.google.com [IPv6:2607:f8b0:4864:20::82a]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 52725130EBB for <tools-discuss@ietf.org>; Mon, 4 Mar 2019 19:24:48 -0800 (PST)
Received: by mail-qt1-x82a.google.com with SMTP id a48so7592694qtb.4 for <tools-discuss@ietf.org>; Mon, 04 Mar 2019 19:24:48 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=J5Dd4ovyL6vXxoKSnYmKP3rY5vhT/yoo2v9FrEdjUPA=; b=aMuHvRMxmT5kXGmtPjDrZGDCSwIO8GCaKT4n+32Y+6/Knil1vYHxUmrBDtCakm0V0V ssLY0pnL3PzV+UfCt5ZizR5uvZDFOSYOS8peJcU0U+9mWRYkytGxGsEtG0OXklIuTl9Y sQQcmqHxjEF7IWaNX3euSvBnnM3GV6qjJ+QXTpKGzTKxFniqqSTZcX30y3qFI2J1ALTY WDxqtkYeiT+nFBcNcrzF90uszNG71HYK/wzRBF64pD/Of8xloPVKeqXQqNJ8xAIVr7FW tEBR7fGcA1241qcqoqLeqSEAX1+brwbD6RBsor2sm57V2N1neNB53Ju5xi3c2GswOGnP SGTw==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=J5Dd4ovyL6vXxoKSnYmKP3rY5vhT/yoo2v9FrEdjUPA=; b=VMlRImfyi/Tg5YiikGO/gWLCMgxVB5fD8D9vEVLDG5qC+edKxp0fPDRCp67xjtp2jw rGcy2osNjDmQ+hCeZM15+TI8bqUnmNeOJfNwfa7kZgVV7a+ahCWoAOdRa/P+d2MzeXHL fMnTPVbunDD8DtUK+vT+BPSlCU3IuA5gR66cBM2NNX94cAlUiQ1cqxCD+BnDcBnjMXu4 HzMTpLDZ7W5ctiJnDQQ4APOXHa2ZzCAKUrwB0I1K5pVPALGrHMzXarRUamw8LpltYXKu JivWFQLlI30buH2RoXiKaVqiKGU67hQ4PVir1LBid3oywI3diF3BsRPf5QcXNB5KJZh9 AUvw==
X-Gm-Message-State: APjAAAVT7s11UzMp43+xtCbVeTgxe9rjk8eZUykA7+CwvnG3BOWc0l4G 1pYornZ3ZRyLkpCgIan6J1JVBGf4RbnLzVkH+D0hV6q6
X-Google-Smtp-Source: APXvYqzQf8IoHOH45g8xOXj4jzwEvZjnybr34Cp1IUlNvJBmzgiJMQaHvhQ6s+5J3TQMXCw2pgVTAFYv4WpkvnPPItM=
X-Received: by 2002:ac8:2a82:: with SMTP id b2mr17245981qta.375.1551756286997; Mon, 04 Mar 2019 19:24:46 -0800 (PST)
MIME-Version: 1.0
References: <sa65zsy1b47.fsf@chopps.org> <CE377055-CF55-4087-AAC7-C8B4DCD5972A@vigilsec.com>
In-Reply-To: <CE377055-CF55-4087-AAC7-C8B4DCD5972A@vigilsec.com>
From: Richard Barnes <richard.barnes@gmail.com>
Date: Mon, 04 Mar 2019 22:24:24 -0500
Message-ID: <CACB24MumcH_5xJ8w3KogVcc1K7CDH0ZsnATuqk5gix9qApGY0A@mail.gmail.com>
To: Russ Housley <housley@vigilsec.com>
Cc: Tools Discussion <tools-discuss@ietf.org>
Content-Type: multipart/alternative; boundary="00000000000043b85f0583506a3c"
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-discuss/cazmbXRlNnE3qnpts72BfPGhn7Y>
Subject: Re: [Tools-discuss] New tool: Using Emacs Org Mode for writing RFCs
X-BeenThere: tools-discuss@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: IETF Tools Discussion <tools-discuss.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/tools-discuss>, <mailto:tools-discuss-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/tools-discuss/>
List-Post: <mailto:tools-discuss@ietf.org>
List-Help: <mailto:tools-discuss-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/tools-discuss>, <mailto:tools-discuss-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 05 Mar 2019 03:24:58 -0000

Is there a brief answer to the question of what advantage this has over
Markdown, which has its own Emacs mode?

https://jblevins.org/projects/markdown-mode/

On Mon, Mar 4, 2019 at 6:36 PM Russ Housley <housley@vigilsec.com> wrote:

> FYI
>
> *From: *Christian Hopps <chopps@chopps.org>
> *Subject: **New tool: Using Emacs Org Mode for writing RFCs*
> *Date: *March 4, 2019 at 6:19:20 PM EST
> *To: *"ietf\@ietf.org" <ietf@ietf.org>
>
>
> Check it out: https://github.com/choppsv1/org-rfc-export
>
> If you are an Emacs user, especially one who is familiar with/uses Org
> Mode, I think you'll like this.
>
> I've been working on an org mode exporter for writing RFCs. As it's now in
> MELPA (package: ox-rfc) I figured it was a good time to announce it's
> availability. Basically you write your RFC in Org Mode and export it to
> XML. The back-end supports exporting to XML (for manual xml2rfc), but also
> supports exporting to text, HTML, or PDF, including directly into a buffer
> for easy previewing.
>
> Highlights:
> - Powerful Org Mode
> - Simple Citations/References.
> - Lists (Numbered, Unnumbered)
> - Definition Lists (term + definition)
> - Tables
> - Embedded Code (Literate Programming e.g., embed yang model, trees,
> examples)
>
> In particular YANG embedding is pretty neat. There's no need for separate
> files and tree generation (and example validation) can be automated from
> the embedded text.
>
> Check out the README and the examples (currently in the ert-tests
> directory).
>
> Thanks,
> Chris.
>
>
> ___________________________________________________________
> Tools-discuss mailing list
> Tools-discuss@ietf.org
> https://www.ietf.org/mailman/listinfo/tools-discuss
>
> Please report datatracker.ietf.org and mailarchive.ietf.org
> bugs at http://tools.ietf.org/tools/ietfdb
> or send email to datatracker-project@ietf.org
>
> Please report tools.ietf.org bugs at
> http://tools.ietf.org/tools/issues
> or send email to webmaster@tools.ietf.org
>