From patchwork Wed Nov 19 11:04:52 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ian Campbell X-Patchwork-Id: 41127 Return-Path: X-Original-To: linaro@patches.linaro.org Delivered-To: linaro@patches.linaro.org Received: from mail-la0-f72.google.com (mail-la0-f72.google.com [209.85.215.72]) by ip-10-151-82-157.ec2.internal (Postfix) with ESMTPS id 8F4E320CBB for ; Wed, 19 Nov 2014 11:08:36 +0000 (UTC) Received: by mail-la0-f72.google.com with SMTP id mc6sf249870lab.3 for ; Wed, 19 Nov 2014 03:08:35 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:delivered-to:message-id:from:to:date:in-reply-to :references:organization:mime-version:cc:subject:precedence:list-id :list-unsubscribe:list-post:list-help:list-subscribe:sender :errors-to:x-original-sender:x-original-authentication-results :mailing-list:list-archive:content-type:content-transfer-encoding; bh=D/RHOFecU9uf1nIkIZCOenfQ8gMvW5F7TT23YapNvSk=; b=TSV94e7fftOZo9Q1aawkFOF3yjucKvHdjaJ+jv0/hvYEXc2i9ICpjfIuqIixqbvtMV 9+fWpuLaCmSiRtVbjRJiea8cR//tU53i1C68d8guJSsacEfpwVeY3taxRE2j/EGnQeaR TUKKq45AjxpKgpq7Bn3pGMx11028ZojKmWJMQFIft8KX4RNQYpWJmHFiQ9qzVixJ5Aji ql0JE8Az+f2qA/67EwJOdaTQUc5WNRXQH81SkFmsxLCJg3ngX4yNUT9nBv+eOaR5Pgvd WcscGUPwV1+B9R9TYq3z7wNiaQB39uwhB5ebzfP+AZsfrqqLX3iglhi8AlNzvjCr4mER Eu+w== X-Gm-Message-State: ALoCoQn/WkaY4rp8NUzcgIrrV/ly0tuOOAQkTnvxOsF3dTWOfl2UP77jXXUXHo1uCQOv0jBq8sB5 X-Received: by 10.152.88.98 with SMTP id bf2mr16307290lab.1.1416395315157; Wed, 19 Nov 2014 03:08:35 -0800 (PST) X-BeenThere: patchwork-forward@linaro.org Received: by 10.152.2.40 with SMTP id 8ls1448982lar.61.gmail; Wed, 19 Nov 2014 03:08:34 -0800 (PST) X-Received: by 10.152.36.201 with SMTP id s9mr41441970laj.17.1416395314773; Wed, 19 Nov 2014 03:08:34 -0800 (PST) Received: from mail-la0-f51.google.com (mail-la0-f51.google.com. [209.85.215.51]) by mx.google.com with ESMTPS id lu4si1474659lac.20.2014.11.19.03.08.34 for (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Wed, 19 Nov 2014 03:08:34 -0800 (PST) Received-SPF: pass (google.com: domain of patch+caf_=patchwork-forward=linaro.org@linaro.org designates 209.85.215.51 as permitted sender) client-ip=209.85.215.51; Received: by mail-la0-f51.google.com with SMTP id mc6so293640lab.10 for ; Wed, 19 Nov 2014 03:08:34 -0800 (PST) X-Received: by 10.152.87.100 with SMTP id w4mr4735531laz.27.1416395314660; Wed, 19 Nov 2014 03:08:34 -0800 (PST) X-Forwarded-To: patchwork-forward@linaro.org X-Forwarded-For: patch@linaro.org patchwork-forward@linaro.org Delivered-To: patch@linaro.org Received: by 10.112.184.201 with SMTP id ew9csp63313lbc; Wed, 19 Nov 2014 03:08:31 -0800 (PST) X-Received: by 10.140.95.106 with SMTP id h97mr28803336qge.97.1416395310947; Wed, 19 Nov 2014 03:08:30 -0800 (PST) Received: from lists.xen.org (lists.xen.org. [50.57.142.19]) by mx.google.com with ESMTPS id s3si1408671qan.100.2014.11.19.03.08.30 for (version=TLSv1 cipher=RC4-SHA bits=128/128); Wed, 19 Nov 2014 03:08:30 -0800 (PST) Received-SPF: none (google.com: xen-devel-bounces@lists.xen.org does not designate permitted sender hosts) client-ip=50.57.142.19; Received: from localhost ([127.0.0.1] helo=lists.xen.org) by lists.xen.org with esmtp (Exim 4.72) (envelope-from ) id 1Xr35f-0001K5-R4; Wed, 19 Nov 2014 11:06:27 +0000 Received: from mail6.bemta14.messagelabs.com ([193.109.254.103]) by lists.xen.org with esmtp (Exim 4.72) (envelope-from ) id 1Xr35e-0001K0-1Y for xen-devel@lists.xen.org; Wed, 19 Nov 2014 11:06:26 +0000 Received: from [193.109.254.147] by server-6.bemta-14.messagelabs.com id 43/3C-03145-1B97C645; Wed, 19 Nov 2014 11:06:25 +0000 X-Env-Sender: Ian.Campbell@citrix.com X-Msg-Ref: server-8.tower-27.messagelabs.com!1416395183!13479949!1 X-Originating-IP: [66.165.176.63] X-SpamReason: No, hits=0.0 required=7.0 tests=sa_preprocessor: VHJ1c3RlZCBJUDogNjYuMTY1LjE3Ni42MyA9PiAzMDYwNDg=\n, received_headers: No Received headers X-StarScan-Received: X-StarScan-Version: 6.12.4; banners=-,-,- X-VirusChecked: Checked Received: (qmail 20696 invoked from network); 19 Nov 2014 11:06:24 -0000 Received: from smtp02.citrix.com (HELO SMTP02.CITRIX.COM) (66.165.176.63) by server-8.tower-27.messagelabs.com with RC4-SHA encrypted SMTP; 19 Nov 2014 11:06:24 -0000 X-IronPort-AV: E=Sophos;i="5.07,416,1413244800"; d="scan'208";a="194337046" Message-ID: <1416395092.29243.27.camel@citrix.com> From: Ian Campbell To: Andrew Cooper Date: Wed, 19 Nov 2014 11:04:52 +0000 In-Reply-To: <546C7689.10406@citrix.com> References: <1416391975.29243.16.camel@citrix.com> <546C6FEB.8010308@citrix.com> <1416393024.29243.20.camel@citrix.com> <546C72F8.2020704@citrix.com> <1416393524.29243.21.camel@citrix.com> <1416393997.29243.22.camel@citrix.com> <546C7689.10406@citrix.com> Organization: Citrix Systems, Inc. X-Mailer: Evolution 3.12.7-1 MIME-Version: 1.0 X-DLP: MIA2 Cc: Ian Jackson , xen-devel Subject: Re: [Xen-devel] Strangeness in generated xen-command-line.html X-BeenThere: xen-devel@lists.xen.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Post: , List-Help: , List-Subscribe: , Sender: xen-devel-bounces@lists.xen.org Errors-To: xen-devel-bounces@lists.xen.org X-Removed-Original-Auth: Dkim didn't pass. X-Original-Sender: ian.campbell@citrix.com X-Original-Authentication-Results: mx.google.com; spf=pass (google.com: domain of patch+caf_=patchwork-forward=linaro.org@linaro.org designates 209.85.215.51 as permitted sender) smtp.mail=patch+caf_=patchwork-forward=linaro.org@linaro.org Mailing-list: list patchwork-forward@linaro.org; contact patchwork-forward+owners@linaro.org X-Google-Group-Id: 836684582541 List-Archive: On Wed, 2014-11-19 at 10:52 +0000, Andrew Cooper wrote: > On 19/11/14 10:46, Ian Campbell wrote: > > On Wed, 2014-11-19 at 10:38 +0000, Ian Campbell wrote: > >> I've not been able to find a workaround... > > This works for me... > > > > 8<--------------- > > > > From 3483179d333c47deacfc8c2eb195bf7dc4a555ff Mon Sep 17 00:00:00 2001 > > From: Ian Campbell > > Date: Wed, 19 Nov 2014 10:42:18 +0000 > > Subject: [PATCH] docs: workaround markdown parser error in > > xen-command-line.markdown > > > > Some versions of markdown (specifically the one in Debian Wheezy, currently > > used to generate > > http://xenbits.xen.org/docs/unstable/misc/xen-command-line.html) seem to be > > confused by nested lists in the middle of multi-paragraph parent list entries > > as seen in the com1,com2 entry. > > > > The effect is that the "Default" section of all following entries are replace > > by some sort of hash or checksum (at least, a string of 32 random seeming hex > > digits). > > > > Workaround this issue by making the decriptions of the DPS options a nested > > list, moving the existing nested list describing the options for S into a third > > level list. This seems to avoid the issue, and is arguably better formatting in > > its own right (at least its not a regression IMHO) > > > > Signed-off-by: Ian Campbell > > I had just identified a different way, but this way is slightly better. > > If you take out all the blank lines visible in the context below, the > resulting HTML will be correctly formatted and rather neater (i.e. > without sporadic blank lines). Agreed. 8<------ >From 53398a9729d391f1fb7b6f753a0032b1f3604d4d Mon Sep 17 00:00:00 2001 From: Ian Campbell Date: Wed, 19 Nov 2014 10:42:18 +0000 Subject: [PATCH] docs: workaround markdown parser error in xen-command-line.markdown Some versions of markdown (specifically the one in Debian Wheezy, currently used to generate http://xenbits.xen.org/docs/unstable/misc/xen-command-line.html) seem to be confused by nested lists in the middle of multi-paragraph parent list entries as seen in the com1,com2 entry. The effect is that the "Default" section of all following entries are replace by some sort of hash or checksum (at least, a string of 32 random seeming hex digits). Workaround this issue by making the decriptions of the DPS options a nested list, moving the existing nested list describing the options for S into a third level list. This seems to avoid the issue, and is arguably better formatting in its own right (at least its not a regression IMHO) Signed-off-by: Ian Campbell --- v2: Less blank lines == nicer output. --- docs/misc/xen-command-line.markdown | 21 ++++++++------------- 1 file changed, 8 insertions(+), 13 deletions(-) diff --git a/docs/misc/xen-command-line.markdown b/docs/misc/xen-command-line.markdown index 0830e5f..b7eaeea 100644 --- a/docs/misc/xen-command-line.markdown +++ b/docs/misc/xen-command-line.markdown @@ -247,19 +247,14 @@ Both option `com1` and `com2` follow the same format. * Optionally, a clock speed measured in hz can be specified. * `DPS` represents the number of data bits, the parity, and the number of stop bits. - - `D` is an integer between 5 and 8 for the number of data bits. - - `P` is a single character representing the type of parity: - - * `n` No - * `o` Odd - * `e` Even - * `m` Mark - * `s` Space - - `S` is an integer 1 or 2 for the number of stop bits. - + * `D` is an integer between 5 and 8 for the number of data bits. + * `P` is a single character representing the type of parity: + * `n` No + * `o` Odd + * `e` Even + * `m` Mark + * `s` Space + * `S` is an integer 1 or 2 for the number of stop bits. * `` is an integer which specifies the IO base port for UART registers. * `` is the IRQ number to use, or `0` to use the UART in poll