From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.comp.tex.context/105545 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: "Philipp A." Newsgroups: gmane.comp.tex.context Subject: Re: context command line interface documentation? Date: Mon, 18 Nov 2019 23:11:25 +0100 Message-ID: References: Reply-To: mailing list for ConTeXt users Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="===============3181825158431829715==" Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="165799"; mail-complaints-to="usenet@blaine.gmane.org" To: mailing list for ConTeXt users Original-X-From: ntg-context-bounces@ntg.nl Mon Nov 18 23:12:08 2019 Return-path: Envelope-to: gctc-ntg-context-518@m.gmane.org Original-Received: from zapf.boekplan.nl ([5.39.185.232] helo=zapf.ntg.nl) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1iWpFg-000guc-AE for gctc-ntg-context-518@m.gmane.org; Mon, 18 Nov 2019 23:12:08 +0100 Original-Received: from localhost (localhost [127.0.0.1]) by zapf.ntg.nl (Postfix) with ESMTP id 292C51631C4; Mon, 18 Nov 2019 23:11:45 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at zapf.boekplan.nl Original-Received: from zapf.ntg.nl ([127.0.0.1]) by localhost (zapf.ntg.nl [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id ZuqUlDzfOJgG; Mon, 18 Nov 2019 23:11:41 +0100 (CET) Original-Received: from zapf.ntg.nl (localhost [127.0.0.1]) by zapf.ntg.nl (Postfix) with ESMTP id 25A581631C6; Mon, 18 Nov 2019 23:11:41 +0100 (CET) Original-Received: from localhost (localhost [127.0.0.1]) by zapf.ntg.nl (Postfix) with ESMTP id 4B30C1631C4 for ; Mon, 18 Nov 2019 23:11:40 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at zapf.boekplan.nl Original-Received: from zapf.ntg.nl ([127.0.0.1]) by localhost (zapf.ntg.nl [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id mOXuSoJ0-Rv0 for ; Mon, 18 Nov 2019 23:11:39 +0100 (CET) Received-SPF: Pass (mailfrom) identity=mailfrom; client-ip=209.85.210.51; helo=mail-ot1-f51.google.com; envelope-from=trueflyingsheep@gmail.com; receiver= Original-Received: from mail-ot1-f51.google.com (mail-ot1-f51.google.com [209.85.210.51]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits)) (No client certificate requested) by zapf.ntg.nl (Postfix) with ESMTPS id 8638A162284 for ; Mon, 18 Nov 2019 23:11:39 +0100 (CET) Original-Received: by mail-ot1-f51.google.com with SMTP id 19so6094567otz.1 for ; Mon, 18 Nov 2019 14:11:39 -0800 (PST) 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; bh=Jejhoov5cOuByzrtDbHT/piWARGx8l+KXXwcuqK+iTY=; b=HYlxRjuST3+IpOwydnN/XNAb/u7qjjdsH70BqFb5rf1/YLuwlQGLtfYm+n9Tz//f/p H4kTo3gc7XRyhuHzX6/g0fU+seHeveUDaKyPIW+bmM4Bj08GOee8sdxeS+n94VrfkJKM yKNwTu/6IX3R6c6/73qilwQIqEKxom+VnnpD8bpk5x/d2tRmWNZH8EKQc9+8t0mfSBxO 4AQztGiP90TyZqTXJHCVcsnUFXj6TqkpvizLlxmoPKJtmMuNeXAa1tkDSlxb4nC4kCrY eZ2jGl4Dvy6vPuVkGQ5kjw+WJ7TCK/Q/5NUaKkYqORHQ3c37KYc5rzMPvhN3DFanQafw 3Csg== X-Gm-Message-State: APjAAAU/V/HXxXRWncaptn30mRd4k4x7+dY6Pmir7U54/z8txYX+XCNx eZOCztfn2TP5evSoJcqyd3NUPRhzDCYa3X+EEGuqX9WBU74= X-Google-Smtp-Source: APXvYqxPy021eGLlKb7wH+RICFjlNeL6H72RK/rfVgLRys9oVx5SgGIQ5MFq+zx1JMYB5NITNQcfxeA3jChmiVikpxI= X-Received: by 2002:a9d:7444:: with SMTP id p4mr1246229otk.156.1574115097614; Mon, 18 Nov 2019 14:11:37 -0800 (PST) In-Reply-To: X-BeenThere: ntg-context@ntg.nl X-Mailman-Version: 2.1.26 Precedence: list List-Id: mailing list for ConTeXt users List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: ntg-context-bounces@ntg.nl Original-Sender: "ntg-context" Xref: news.gmane.org gmane.comp.tex.context:105545 Archived-At: --===============3181825158431829715== Content-Type: multipart/alternative; boundary="0000000000003a9d6a0597a63b8c" --0000000000003a9d6a0597a63b8c Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Hi Hans, Very sorry that it was phrased so negatively. I like ConTeXt enough that I wrote my master=E2=80=99s thesis in it, and am now writing my doctor=E2=80= =99s thesis in it. I had a long day that day and didn=E2=80=99t expect to have to dive so deep= to find out what I want is impossible. I think my language mostly reflected my thought process going through it, not lack of respect towards your work. I hope my bug report here is still helpful and provides all information necessary to improve ConTeXt, and would like to help if there=E2=80=99s an = easy way to contribute (Pull requests?) context --silent -nostatistics > Thank you! I see it=E2=80=99s in the =E2=80=9Cexperts=E2=80=9D section in m= tx-context.xml. I added it to the wiki, as it seems the most immediately useful (and non-experty) among those options. I think it would be best if the help would just be generated from that file to reduce the sources of truth in existence. > context quits at the first error as recovering is (1) seldom useful, (2) > can interfere badly with tex/mp/lua and make things worse), (3) context > tries to show a bit more precise location where the erro comes from (not > always easy in tex) ... some of these modes originate in paper terminal > times and it's very unlikely that context will change it's current way of > doing things > What you=E2=80=99re describing is the behavior I=E2=80=99m trying to achiev= e. The error location reporting works for me, but context will still continue after an error for me: If I don=E2=80=99t specify --nonstopmode or so it=E2=80=99ll try to recover= , and even when I specify it, there will be other output after the error. > What=E2=80=99s a =E2=80=9Clist=E2=80=9D? comma separated? Do I need stri= ng delimiters? > > comma separated and only quoted when spaces (as usual with spaces) > You mean quoted as in =E2=80=9Cto prevent my terminal from interpreting it = wrong=E2=80=9D, right? Not that the script actually expects quotes in argv? grepping for stats will bring you to nostats and nostatistics and "context > --help --expert" shows that flag too > All of which is undocumented. I=E2=80=99d like to help here, so I added it = to the wiki, but it would be useful to mention this in --help, too! remarks like the last one are very unlikely to trigger people to write > additional documentation (a manual or wiki page) ... context comes for > free, support comes for free ... there is not much one can demand i guess > > Hans > Again, I=E2=80=99m really sorry! I=E2=80=99d like to help, but I don=E2=80= =99t have the time currently for more than drive-by pull requests and wiki edits. I=E2=80=99m = doing the latter and if the former is possible, I=E2=80=99ll try my hand. Is it? Best, Philipp --0000000000003a9d6a0597a63b8c Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
Hi Hans,

Very sorry that it was phrased so negatively. I like ConTeXt enough= that I wrote my master=E2=80=99s thesis in it, and am now writing my docto= r=E2=80=99s thesis in it.
I had a long day that day and didn=E2= =80=99t expect to have to dive so deep to find out what I want is impossibl= e. I think my language mostly reflected my thought process going through it= , not lack of respect towards your work.
I hope my bug report= here is still helpful and provides all information necessary to improve Co= nTeXt, and would like to help if there=E2=80=99s an easy way to contribute = (Pull requests?)

context --silent -nostatistics

Thank yo= u! I see it=E2=80=99s in the =E2=80=9Cexperts=E2=80=9D section in mtx-conte= xt.xml. I added it to the wiki, as it seems the most immediately useful (an= d non-experty) among those options.
I think it would be best = if the help would just be generated from that file to reduce the sources of= truth in existence.
=C2=A0
context quits at the first error as recovering is (1) seldom useful, (2) ca= n interfere badly with tex/mp/lua and make things worse), (3) context tries= to show a bit more precise location where the erro comes from (not always = easy in tex) ... some of these modes originate in paper terminal times and = it's very unlikely that context will change it's current way of doi= ng things

What you=E2=80=99re describin= g is the behavior I=E2=80=99m trying to achieve. The error location reporti= ng works for me, but context will still continue after an error for me:
If I don=E2=80=99t specify --nonstopmode or so it=E2=80=99ll try to = recover, and even when I specify it, there will be other output after the e= rror.

>=C2=A0 What=E2=80=99s a =E2=80=9Clist=E2=80=9D? comma separated? Do I n= eed string delimiters?

comma separated and only quoted when spaces (as usual with spaces)

You mean quoted as in =E2=80=9Cto prevent my te= rminal from interpreting it wrong=E2=80=9D, right?
Not that the s= cript actually expects quotes in argv?

grepping for stats will bring you to nostats and nostatistics and "con= text --help --expert" shows that flag too

All of which is undocumented. I=E2=80=99d like to help here, so I a= dded it to the wiki, but it would be useful to mention this in --help, too!=

remarks like the last one are very unlikely to trigger people to write addi= tional documentation (a manual or wiki page) ... context comes for free, su= pport comes for free ... there is not much one can demand i guess

Hans

Again, I=E2=80=99m really sorry! I= =E2=80=99d like to help, but I don=E2=80=99t have the time currently for mo= re than drive-by pull requests and wiki edits. I=E2=80=99m doing the latter= and if the former is possible, I=E2=80=99ll try my hand. Is it?
<= div>
Best, Philipp
--0000000000003a9d6a0597a63b8c-- --===============3181825158431829715== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: base64 Content-Disposition: inline X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX18KSWYgeW91ciBxdWVzdGlvbiBpcyBvZiBpbnRlcmVz dCB0byBvdGhlcnMgYXMgd2VsbCwgcGxlYXNlIGFkZCBhbiBlbnRyeSB0byB0aGUgV2lraSEKCm1h aWxsaXN0IDogbnRnLWNvbnRleHRAbnRnLm5sIC8gaHR0cDovL3d3dy5udGcubmwvbWFpbG1hbi9s aXN0aW5mby9udGctY29udGV4dAp3ZWJwYWdlICA6IGh0dHA6Ly93d3cucHJhZ21hLWFkZS5ubCAv IGh0dHA6Ly9jb250ZXh0LmFhbmhldC5uZXQKYXJjaGl2ZSAgOiBodHRwczovL2JpdGJ1Y2tldC5v cmcvcGhnL2NvbnRleHQtbWlycm9yL2NvbW1pdHMvCndpa2kgICAgIDogaHR0cDovL2NvbnRleHRn YXJkZW4ubmV0Cl9fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fCg== --===============3181825158431829715==--