IETF Logo Mail Archive

Re: [Cellar] FLAC Specification Formatting Question

Martijn van Beurden <mvanb1@gmail.com> Sun, 10 December 2023 08:19 UTC

Return-Path: <mvanb1@gmail.com>
X-Original-To: cellar@ietfa.amsl.com
Delivered-To: cellar@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 5D7ECC151707 for <cellar@ietfa.amsl.com>; Sun, 10 Dec 2023 00:19:05 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -6.856
X-Spam-Level:
X-Spam-Status: No, score=-6.856 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_ENVFROM_END_DIGIT=0.25, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_HI=-5, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01, URIBL_DBL_BLOCKED_OPENDNS=0.001, URIBL_ZEN_BLOCKED_OPENDNS=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 ([50.223.129.194]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id vMDiQXbtl2aP for <cellar@ietfa.amsl.com>; Sun, 10 Dec 2023 00:19:01 -0800 (PST)
Received: from mail-lf1-x130.google.com (mail-lf1-x130.google.com [IPv6:2a00:1450:4864:20::130]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id D73D5C15106A for <cellar@ietf.org>; Sun, 10 Dec 2023 00:19:01 -0800 (PST)
Received: by mail-lf1-x130.google.com with SMTP id 2adb3069b0e04-50bfa5a6cffso3933167e87.0 for <cellar@ietf.org>; Sun, 10 Dec 2023 00:19:01 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1702196340; x=1702801140; darn=ietf.org; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:from:to:cc:subject:date:message-id:reply-to; bh=52XGmOEoNULqqAAW6kSHFxamWzegei6I31rbTSHrXbg=; b=jKOwaf9NPstuGzQRzfalf/VCit8NrunQzoDs7z+AXvr5CsnkRaOZsukD4eLfq2YLqi pZNJVUUJSt7joJg2MgLKHOAWejIERZ8A1ZwuyZ62diA5Jr0uBLcd2A3KMnohshVH5dqJ 7gEK+WlDphrE7LTGuY+Vy9C9CnOa7EJrI8Gq0onbXaW6lOmfU5Uv/dc1wkKtVW6ro4pY oX33YYSqqkJSEgaCbw4Ke8BY0whsx433rUgKa5WQlyz8NK85wNOYeNqubxoCGyqoHH3/ H9IfQiZmw8ffha0yKWnYAkelko4k89LFyXGSoBh9uLcBkFwvUOu4SM60xcvml01WIDWL lhKg==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1702196340; x=1702801140; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=52XGmOEoNULqqAAW6kSHFxamWzegei6I31rbTSHrXbg=; b=RHeaNS5Q+3W74wDtmsEhGrzs6gZSZ5OixCAA3cgQtqkto/24Y9bXB1zHNbsf3nVKmT xMLd6nN1maopVnLPwn5jL9380d6JWzeWjZAtR/eWuHoGZpc2829mR+zsDhfmBt8TQw+Z 3VLp1bWtucs4VoH9hwfHCXd2kARmF96EVuhFO3TyzqqMnirWInFm1p3z4iDQkyT2QWw9 o7wIaquvQ4MLsAAybLnOvglK8AOFLznfsagpRW13RnL+AeOe2h0hS5XhZ/ODgL9wvY8g lvDrl6ASfNVW3EUcfCl9y46GwdwYgxQdG1FMU9nHZVPkO1+LdJ/74ioaIt7qC8SWuRbr 6mcQ==
X-Gm-Message-State: AOJu0YyiNORybnQSEyoK66UL8G6cknjs25/EMO6NJF/tDUcl3sCiKBWa 8FffKyjm8QYx8o/Dpqju+FsQzWkLQTvhyS5umes=
X-Google-Smtp-Source: AGHT+IGGEeW9FzJGStNEKDE7hWYxZoEUHwH4R4Q866OLixulMPEHMYMgpxJfmqIkgDGvmRnGq23Ax7+UwlR4kaNs8j0=
X-Received: by 2002:a19:f60f:0:b0:50b:f7c6:2f7a with SMTP id x15-20020a19f60f000000b0050bf7c62f7amr839281lfe.47.1702196339503; Sun, 10 Dec 2023 00:18:59 -0800 (PST)
MIME-Version: 1.0
References: <CABXUEzM8QX46qUVm2LjUpeiQQF9N4vFsxH5fG=QbcP=yp7Q3XQ@mail.gmail.com>
In-Reply-To: <CABXUEzM8QX46qUVm2LjUpeiQQF9N4vFsxH5fG=QbcP=yp7Q3XQ@mail.gmail.com>
From: Martijn van Beurden <mvanb1@gmail.com>
Date: Sun, 10 Dec 2023 09:18:48 +0100
Message-ID: <CADQbU69jr3BicwXQEs_oLNPBYMoL0tuF=ttAFo_htdc_ecdcMg@mail.gmail.com>
To: George Kuegler <georgekuegler@gmail.com>
Cc: cellar@ietf.org
Content-Type: text/plain; charset="UTF-8"
Archived-At: <https://mailarchive.ietf.org/arch/msg/cellar/Ot0y5AYWWSj08vu3G0j0LyhNfN8>
Subject: Re: [Cellar] FLAC Specification Formatting Question
X-BeenThere: cellar@ietf.org
X-Mailman-Version: 2.1.39
Precedence: list
List-Id: Codec Encoding for LossLess Archiving and Realtime transmission <cellar.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/cellar>, <mailto:cellar-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/cellar/>
List-Post: <mailto:cellar@ietf.org>
List-Help: <mailto:cellar-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/cellar>, <mailto:cellar-request@ietf.org?subject=subscribe>
X-List-Received-Date: Sun, 10 Dec 2023 08:19:05 -0000

Hi,

The workflow is coded in a Makefile:
https://github.com/ietf-wg-cellar/flac-specification/blob/master/Makefile

In short, all changes are made in markdown, with git being the version
control system. Git repository is here:
https://github.com/ietf-wg-cellar/flac-specification

This markdown file is converted to the IETF-specific XML format. The
schema is explained here: https://ietf-tools.github.io/xml2rfc/

This xml is then converted to txt, html, and pdf using the IETF
xml2rfc tool. When submitting a new draft version, the xml is
submitted and the xml to txt conversion is therefore not something
this working group has any influence on.

Kind regards, Martijn van Beurden

Op zo 10 dec 2023 om 04:07 schreef George Kuegler <georgekuegler@gmail.com>:
>
> Hello,
>
> I was reading the 'draft-ietf-cellar-flac-12' specs and I noticed how clean the formatting was with plaintext. Which software or workflow was used for publishing?
>
> I apologize if the question is silly. All the specifications in my industry are published with Microsoft Word or XML based software.
>
> Cheers!
> George K.
> _______________________________________________
> Cellar mailing list
> Cellar@ietf.org
> https://www.ietf.org/mailman/listinfo/cellar

v2.23.0 | Report a Bug | By Email