From mboxrd@z Thu Jan 1 00:00:00 1970
Return-Path: <lists@sr.ht>
Received: from mp0.migadu.com ([2001:41d0:403:58f0::])
(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))
by ms5.migadu.com with LMTPS
id 2HdqLIAW22bFSAAAqHPOHw:P1
(envelope-from <lists@sr.ht>)
for <patches@johnnyrichard.com>; Fri, 06 Sep 2024 16:49:36 +0200
Received: from aspmx1.migadu.com ([2001:41d0:403:58f0::])
(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))
by mp0.migadu.com with LMTPS
id 2HdqLIAW22bFSAAAqHPOHw
(envelope-from <lists@sr.ht>)
for <patches@johnnyrichard.com>; Fri, 06 Sep 2024 16:49:36 +0200
X-Envelope-To: patches@johnnyrichard.com
Authentication-Results: aspmx1.migadu.com;
dkim=pass header.d=lists.sr.ht header.s=20240113 header.b=irNwBAcR;
dkim=pass header.d=johnnyrichard.com header.s=key1 header.b=zP9JQCVZ;
dmarc=pass (policy=quarantine) header.from=johnnyrichard.com;
spf=pass (aspmx1.migadu.com: domain of lists@sr.ht designates 46.23.81.152 as permitted sender) smtp.mailfrom=lists@sr.ht
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed;
d=johnnyrichard.com; s=key1; t=1725634176;
h=from:from:sender:sender:reply-to:subject:subject:date:date:
message-id:message-id:to:to:cc:cc:mime-version:mime-version:
content-type:content-type:
content-transfer-encoding:content-transfer-encoding:
in-reply-to:in-reply-to:references:references:list-id:
list-unsubscribe:list-subscribe:list-post:dkim-signature;
bh=T31jEad8ho7ptEYHCTVFUJWiujbYDH5PyjS37mSjGkU=;
b=Tvj8ebpAp64PxQPfW2PxSjovlbwNmXEZ1powdcaXXmHpr8tYEYcdKLiP4MqZBAnbzJ6tVy
dZpbmyqk93ROc804hLl4xcpF8UTc0r5NFdT2mKhnmZKi/OwpLjAztO/BgWEi4YVTMizMeB
O6ABf+zP/Zuz4mDg0ftIZjDe5LA2Y+wjIl+UF5q29bVwMgNN/YhH1kY33et5WtHSltFU+N
m2IbJlbHulXs8EbU8kEqqmbWZ/NiRmumLu9xKig56LujSnTbshGWpFXrlc/WCk0bKkH25e
GnOlBtLnUCpFwPf4JFDXAplmyMh+fYzS6byaIaOSoNFuzpcOBups8RmhbDgHgg==
ARC-Seal: i=1; s=key1; d=johnnyrichard.com; t=1725634176; a=rsa-sha256;
cv=none;
b=XJLU0RSvTOWLqBrgzeFIKLCmCEdskYRIlx+Dc2Vq77iSt8NVM7yd5kcPCLxxq2/S2Gs5oU
dPdnqj+FFy4p7BkcQdZdnN6tVXF5dmDp+Nex8Go8+cFDmuUMIjFkMmJs38Oe9MfZYFRaFB
nRbLKGkB1b9vGcJWu4lN0XZ5clLi8bekPNFmNZwgrtt8yFEL0S98Ot2Bxtbwm4+skzI7UZ
Ui4Bo3ZUeM5Pwtbi2JUW17j8chZveJeAHml3mem1yOc+Pl22WUxpQ6ve9ElpcLQBGZgJ1S
7hHMEclXI7P1JbyqNcW7SpyCrKHkOX+vgSDMX3BhHJtSrPHi2/JuBmS23kc+Zg==
ARC-Authentication-Results: i=1;
aspmx1.migadu.com;
dkim=pass header.d=lists.sr.ht header.s=20240113 header.b=irNwBAcR;
dkim=pass header.d=johnnyrichard.com header.s=key1 header.b=zP9JQCVZ;
dmarc=pass (policy=quarantine) header.from=johnnyrichard.com;
spf=pass (aspmx1.migadu.com: domain of lists@sr.ht designates 46.23.81.152 as permitted sender) smtp.mailfrom=lists@sr.ht
Received: from mail-a.sr.ht (mail-a.sr.ht [46.23.81.152])
(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256)
(No client certificate requested)
by aspmx1.migadu.com (Postfix) with ESMTPS id 9CA31662BA
for <patches@johnnyrichard.com>; Fri, 06 Sep 2024 16:49:36 +0200 (CEST)
DKIM-Signature: a=rsa-sha256; bh=6/ql5AcQgcCLspBETv3Z6DxLok+W4AsL/020geZgbLY=;
c=simple/simple; d=lists.sr.ht;
h=Date:From:To:Cc:Subject:References:In-Reply-To:List-Unsubscribe:List-Subscribe:List-Archive:List-Post:List-ID;
q=dns/txt; s=20240113; t=1725634175; v=1;
b=irNwBAcR2fYB24TIRDq6DvRk/VvpUn8R5H1O0xG62/+YDOoEF0eF8B8Pq3lzP1QNd1zh1qKv
dgXXAAhhxkjTa8Z0rQbmXe2IkZwjXG7Zl+KtcE0lEESF0gD3KfNjQySpF0dEDbP40wCR75lc58l
tpcSOhDY9uqzyb9pORCidMvA7dxNLWjC8m1urFRxK7ekOPmNmdQRjXiHkgxFEN6rf83WnA3Kvp8
U6vNpvtXD9/8TwOpLSXKooVpotkqH2kVka1X54dKV8HKz6BWNtcrkzvj49vsf2bw3gl4pSrCrLg
wrKVQMzlKFGHp/gGkeQHlvkiALnjTlGYO68WNxpkBUBjw==
Received: from lists.sr.ht (unknown [46.23.81.154])
by mail-a.sr.ht (Postfix) with ESMTPSA id 848EE2038A
for <patches@johnnyrichard.com>; Fri, 06 Sep 2024 14:49:35 +0000 (UTC)
Received: from out-183.mta0.migadu.com (out-183.mta0.migadu.com [91.218.175.183])
by mail-a.sr.ht (Postfix) with ESMTPS id B0C792034F
for <~johnnyrichard/olang-devel@lists.sr.ht>; Fri, 06 Sep 2024 14:49:34 +0000 (UTC)
Date: Fri, 6 Sep 2024 16:49:10 +0200
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=johnnyrichard.com;
s=key1; t=1725634173;
h=from:from:reply-to:subject:subject:date:date:message-id:message-id:
to:to:cc:cc:mime-version:mime-version:content-type:content-type:
content-transfer-encoding:content-transfer-encoding:
in-reply-to:in-reply-to:references:references;
bh=T31jEad8ho7ptEYHCTVFUJWiujbYDH5PyjS37mSjGkU=;
b=zP9JQCVZ58GOMWC8PuZxdZ9pg3wTI7ZhFNH/QoF5lLalOKZ9vMlwRm4tJWqAI/B5pKr18W
q4RfCTsRzGbUBwv3KnzuqNjVB1s9xbBQqfjRIfbYZmWx2ToOlcekzTnpkYqjqJR1qt9/rW
bfhjqp2jcT5QgK/2+5SD6+q1miqs4svDd7yOIZvoweWfabJN1XFgUvWa6bm4X8PBdzSM0q
HD+Qmkj8GovAmfoN1xxdmzuQmYdS2UknA9OSKwJCYOY/cBR1+FLFaOvcGCNWWl3I7PzMvc
d8tVpJQmbp3lxCHUBRUSSIie3li29ywnubPp8dw6Achvx4onNACfhYQZx8U+tw==
X-Report-Abuse: Please report any abuse attempt to abuse@migadu.com and include these headers.
From: Johnny Richard <johnny@johnnyrichard.com>
To: Carlos Maniero <carlos@maniero.me>
Cc: ~johnnyrichard/olang-devel@lists.sr.ht
Subject: Re: [PATCH olang v1] docs: Create olang manual document bootstrap
Message-ID: <6cf2oxsllqw7rz5kmtkp4xwkkmdbqwmaxex6axvblj4iw3esqv@7qkb4s34dhuo>
X-Sourcehut-Patchset-Update: APPLIED
References: <20240905193854.18350-1-johnny@johnnyrichard.com>
<D3YPWP8NWQ33.3SXYFPUW1SXA6@maniero.me>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: <D3YPWP8NWQ33.3SXYFPUW1SXA6@maniero.me>
X-Sourcehut-Patchset-Status: UNKNOWN
List-Unsubscribe: <mailto:~johnnyrichard/olang-devel+unsubscribe@lists.sr.ht?subject=unsubscribe>
List-Subscribe: <mailto:~johnnyrichard/olang-devel+subscribe@lists.sr.ht?subject=subscribe>
List-Archive: <https://lists.sr.ht/~johnnyrichard/olang-devel>
Archived-At: <https://lists.sr.ht/~johnnyrichard/olang-devel/%3C6cf2oxsllqw7rz5kmtkp4xwkkmdbqwmaxex6axvblj4iw3esqv%407qkb4s34dhuo%3E>
List-Post: <mailto:~johnnyrichard/olang-devel@lists.sr.ht>
List-ID: ~johnnyrichard/olang-devel <~johnnyrichard/olang-devel.lists.sr.ht>
Sender: ~johnnyrichard/olang-devel <~johnnyrichard/olang-devel@lists.sr.ht>
X-Migadu-Flow: FLOW_IN
X-Migadu-Country: NL
X-Migadu-Spam-Score: -3.12
X-Spam-Score: -3.12
X-Migadu-Queue-Id: 9CA31662BA
X-Migadu-Scanner: mx11.migadu.com
X-TUID: It6fbFtlHHTl
Thanks for reviewing it. I found few issues with the patch (build and
styling) and adjusted in a fixup commit bellow:
Build: https://builds.sr.ht/~johnnyrichard/job/1320980
To git.sr.ht:~johnnyrichard/olang
b1023a7..be71d16 HEAD -> main
---->8----
Subject: [PATCH olang] fixup! docs: Create olang manual document bootstrap
diff --git a/.build.yml b/.build.yml
index 01f4aab..3cbba82 100644
--- a/.build.yml
+++ b/.build.yml
@@ -6,6 +6,7 @@ packages:
- hut
- clang
- pandoc-cli
+ - texinfo
environment:
site: o-lang.org
sources:
diff --git a/docs/manual/contribution-guide.texi b/docs/manual/contribution-guide.texi
index 4c6e458..856d0f6 100644
--- a/docs/manual/contribution-guide.texi
+++ b/docs/manual/contribution-guide.texi
@@ -6,7 +6,7 @@ the world. Everyone is welcome to join us. If you want to catch up the language
development, you can subscribe to our mailing list or join the #olang IRC
channel on Libera network.
-Olang is hosted on a @strong{git repository}
+Olang source code is available on @strong{git}
@url{https://git.sr.ht/~johnnyrichard/olang}
@c ----------------------------------------------------------------------------
@@ -136,15 +136,12 @@ Any additional comments not suitable for the changelog
The actual patch (@code{diff} output).
@end enumerate
-
Sometimes you might need to break down your patch into multiple patches. In
this case a patchset should be sent.
-
Patchesets MUST contain a @strong{cover letter} followed by a good description.
It is easily achievable with the @code{--cover-letter} argument available on
@code{git format-patch} and @code{git send-email} commands.
-
@subsection Creating Patches
You can create a patch using the command:
@@ -231,7 +228,7 @@ $ git format-patch --cover-letter -M origin/main -o outgoing/ -v2
Whenever you need to reply emails comments, please avoid
@url{https://en.wikipedia.org/wiki/Posting_style, top posting}, do
-@strong{botton posting} instead. Read more about it here
+@strong{bottom posting} instead. Read more about it here
@url{https://useplaintext.email/#etiquette}.
@c ----------------------------------------------------------------------------
@@ -246,7 +243,7 @@ Whenever you need to reply emails comments, please avoid
Send a @strong{plain text} email to
@email{~johnnyrichard/olang-devel+subscribe@@lists.sr.ht} to subscribe to our
-deve mailing list.
+dev mailing list.
You should be able to find older threads by searching into our archives, which
is hosted at @url{https://lists.sr.ht/~johnnyrichard/olang-devel}.
diff --git a/docs/manual/style.css b/docs/manual/style.css
index 41b1b3f..db32c05 100644
--- a/docs/manual/style.css
+++ b/docs/manual/style.css
@@ -1,32 +1,3 @@
-@font-face {
- font-family: 'Red Hat Mono';
- font-style: italic;
- font-weight: 300;
- font-display: swap;
- src: url(https://johnnyrichard.com/static/fonts/RedHatMono-Italic.ttf) format('truetype');
-}
-@font-face {
- font-family: 'Red Hat Mono';
- font-style: italic;
- font-weight: 500;
- font-display: swap;
- src: url(https://johnnyrichard.com/static/fonts/RedHatMono-BoldItalic.ttf) format('truetype');
-}
-@font-face {
- font-family: 'Red Hat Mono';
- font-style: normal;
- font-weight: 300;
- font-display: swap;
- src: url(https://johnnyrichard.com/static/fonts/RedHatMono-Regular.ttf) format('truetype');
-}
-@font-face {
- font-family: 'Red Hat Mono';
- font-style: normal;
- font-weight: 500;
- font-display: swap;
- src: url(https://johnnyrichard.com/static/fonts/RedHatMono-SemiBold.ttf) format('truetype');
-}
-
:root {
--background-color: #f4f4f4;
--text-color: black;
@@ -41,10 +12,6 @@
}
}
-h1, h2, h3, h4, h5, h6, b, strong {
- font-weight: 500;
-}
-
div.example {
margin: 0;
}
@@ -54,12 +21,12 @@ body {
color: var(--text-color);
margin: 0;
padding: 0 40px;
+ font-size: 11pt;
+ font-family: monospace;
}
-body, pre {
- font-weight: 300;
- font-family: "Red Hat Mono";
- font-size: 1.4rem;
+.example-formatted {
+ font-family: monospace;
}
a {
@@ -67,7 +34,7 @@ a {
}
body > * {
- max-width: 1024px;
+ max-width: 800px;
margin: 10px auto;
}
@@ -89,7 +56,6 @@ footer {
}
body > * {
- line-height: 1.75rem;
overflow: hidden;
}
diff --git a/docs/template.html b/docs/template.html
index 0f5a207..be5cbf5 100644
--- a/docs/template.html
+++ b/docs/template.html
@@ -70,7 +70,7 @@
<h1><span class="logo-name">olang</span> | O Programming Language</h1>
<nav>
[ <a href="/">Home</a> ]
- [ <a href="/manual">Manual</a> ]
+ [ <a href="/manual/">Manual</a> ]
[ <a href="/pages/language-specification.html">Specification</a> ]
[ <a href="https://sr.ht/~johnnyrichard/olang/sources" target="_blank">Sources ↗</a> ]
[ <a href="https://sr.ht/~johnnyrichard/olang/lists" target="_blank">Mailing list ↗</a> ]