forked from lda/telodendria
Move send-patch and td to section one of the manual.
I think they fit there better.
This commit is contained in:
parent
64add9c9ab
commit
b4a394c44b
6 changed files with 118 additions and 24 deletions
|
@ -1,5 +1,5 @@
|
||||||
.Dd $Mdocdate: November 27 2022 $
|
.Dd $Mdocdate: March 10 2023 $
|
||||||
.Dt SEND-PATCH 8
|
.Dt SEND-PATCH 1
|
||||||
.Os Telodendria Project
|
.Os Telodendria Project
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm send-patch
|
.Nm send-patch
|
||||||
|
@ -11,11 +11,14 @@
|
||||||
.Nm
|
.Nm
|
||||||
is a simple shell script for submitting patch files to Telodendria's patch
|
is a simple shell script for submitting patch files to Telodendria's patch
|
||||||
room for review. Do note that it depends on
|
room for review. Do note that it depends on
|
||||||
.Xr jq 1
|
.Xr json 1
|
||||||
and
|
and
|
||||||
.Xr curl 1 ,
|
.Xr curl 1 ,
|
||||||
and so may not work out of the box on some systems. However, these tools are
|
and so may not work out of the box on some systems. However,
|
||||||
readily available for most systems. Please consult your package manager's
|
.Xr json 1
|
||||||
|
ships with Telodendria, and
|
||||||
|
.Xr curl 1
|
||||||
|
is readily available for most systems. Please consult your package manager's
|
||||||
manual for installing packages.
|
manual for installing packages.
|
||||||
.Pp
|
.Pp
|
||||||
.Nm
|
.Nm
|
||||||
|
@ -54,10 +57,10 @@ password authentication flow.
|
||||||
does utilize the
|
does utilize the
|
||||||
.Pa .env
|
.Pa .env
|
||||||
file, just like
|
file, just like
|
||||||
.Xr td 8 .
|
.Xr td 1 .
|
||||||
Consult that page for the specifics of the
|
Consult that page for the specifics of the
|
||||||
.Pa .env
|
.Pa .env
|
||||||
file.
|
file.
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Xr td 8
|
.Xr td 1
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
.Dd $Mdocdate: February 15 2023 $
|
.Dd $Mdocdate: March 10 2023 $
|
||||||
.Dt TD 8
|
.Dt TD 1
|
||||||
.Os Telodendria Project
|
.Os Telodendria Project
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm td
|
.Nm td
|
|
@ -1,4 +1,4 @@
|
||||||
.Dd $Mdocdate: November 20 2022 $
|
.Dd $Mdocdate: March 10 2023 $
|
||||||
.Dt PORTING 7
|
.Dt PORTING 7
|
||||||
.Os Telodendria Project
|
.Os Telodendria Project
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
|
@ -23,7 +23,7 @@ That being said, this page aims to assist those who want to package
|
||||||
Telodendria for their operating system or software distribution.
|
Telodendria for their operating system or software distribution.
|
||||||
.Pp
|
.Pp
|
||||||
See
|
See
|
||||||
.Xr td 8
|
.Xr td 1
|
||||||
for instructions on how to build Telodendria. Only proceed with packaging
|
for instructions on how to build Telodendria. Only proceed with packaging
|
||||||
Telodendria after you have successfully built it on your operating system.
|
Telodendria after you have successfully built it on your operating system.
|
||||||
.Pp
|
.Pp
|
||||||
|
@ -155,5 +155,5 @@ OpenBSD port.
|
||||||
.Pp
|
.Pp
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Xr telodendria-contributing 7 ,
|
.Xr telodendria-contributing 7 ,
|
||||||
.Xr td 8 ,
|
.Xr td 1 ,
|
||||||
.Xr telodendria 7
|
.Xr telodendria 7
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
.Dd $Mdocdate: March 8 2023 $
|
.Dd $Mdocdate: March 10 2023 $
|
||||||
.Dt TELODENDRIA-CHANGELOG 7
|
.Dt TELODENDRIA-CHANGELOG 7
|
||||||
.Os Telodendria Project
|
.Os Telodendria Project
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
|
@ -38,13 +38,104 @@ support, an HTTP client, and more! The third major release of
|
||||||
packs a lot of general improvements on top of supporting more of
|
packs a lot of general improvements on top of supporting more of
|
||||||
the Matrix specification.
|
the Matrix specification.
|
||||||
.Pp
|
.Pp
|
||||||
|
Matrix Specification:
|
||||||
.Bl -bullet
|
.Bl -bullet
|
||||||
.It
|
.It
|
||||||
Added a simple HTTP client API, which will be used for federation.
|
Added support for the
|
||||||
This release also ships with a simple command line tool similar to
|
.Pa /_matrix/client/v3/account/whoami
|
||||||
|
endpoint.
|
||||||
|
.El
|
||||||
|
.Pp
|
||||||
|
New Features:
|
||||||
|
.Bl -bullet
|
||||||
|
.It
|
||||||
|
Added a new
|
||||||
|
.Xr HttpClient 3
|
||||||
|
API for making HTTP requests. This will eventually be used for
|
||||||
|
federating with other Matrix homeservers.
|
||||||
|
.It
|
||||||
|
Added support for pretty-printing JSON to
|
||||||
|
.Xr Json 3 .
|
||||||
|
.Nm
|
||||||
|
itself doesn't pretty-print JSON, but this is useful for debugging
|
||||||
|
and building useful tools.
|
||||||
|
.It
|
||||||
|
Added a handful of useful development tools built on the
|
||||||
|
.Nm
|
||||||
|
APIs. New tools include
|
||||||
|
.Xr http 1 ,
|
||||||
|
a command line tool for making HTTP requests, similar to
|
||||||
|
.Xr curl 1 ,
|
||||||
|
.Xr json 1 ,
|
||||||
|
a command line tool for working with JSON, similar to
|
||||||
|
.Xr jq 1 ,
|
||||||
|
and
|
||||||
|
.Xr http-debug-server 1 ,
|
||||||
|
a simple HTTP server that just prints requests out to standard
|
||||||
|
output and returns an empty JSON object.
|
||||||
|
.Nm http
|
||||||
|
and
|
||||||
|
.Nm json
|
||||||
|
are replacements for
|
||||||
.Xr curl 1
|
.Xr curl 1
|
||||||
that can be used for testing
|
and
|
||||||
.Nm .
|
.Xr jq 1
|
||||||
|
that build on the
|
||||||
|
.Xr HttpClient 3
|
||||||
|
and
|
||||||
|
.Xr Json
|
||||||
|
APIs. They exist mainly to test those APIs, but also to reduce
|
||||||
|
the number of dependencies that
|
||||||
|
.Nm
|
||||||
|
has.
|
||||||
|
.Nm http-debug-server
|
||||||
|
exists to test the
|
||||||
|
.Xr HttpServer 3
|
||||||
|
and
|
||||||
|
.Xr HttpClient
|
||||||
|
APIs.
|
||||||
|
.It
|
||||||
|
Replaced all usage of
|
||||||
|
.Xr jq 1
|
||||||
|
with the new
|
||||||
|
.Xr json 1
|
||||||
|
tool.
|
||||||
|
.Xr jq 1
|
||||||
|
is no longer a development dependency.
|
||||||
|
.It
|
||||||
|
Added a new
|
||||||
|
.Xr tt 1
|
||||||
|
script for easily making Matrix requests against
|
||||||
|
.Nm
|
||||||
|
in development.
|
||||||
|
.El
|
||||||
|
.Pp
|
||||||
|
Fixes and general improvements:
|
||||||
|
.Bl -bullet
|
||||||
|
.It
|
||||||
|
Fixed a few warnings that were generated on some obscure compilers.
|
||||||
|
.It
|
||||||
|
Moved the
|
||||||
|
.Fn main
|
||||||
|
function into its own file to make it easier to link other programs
|
||||||
|
with the
|
||||||
|
.Nm
|
||||||
|
APIs.
|
||||||
|
.It
|
||||||
|
Fixed the development tools environment setup script. Apparently
|
||||||
|
using a hyphen as a bullet point is not very portable, because some
|
||||||
|
shell implementations of
|
||||||
|
.Xr printf 1
|
||||||
|
interpret it as a flag. Switched to an asterisk instead.
|
||||||
|
.It
|
||||||
|
Fixed some intermittent I/O errors that would occur as a result of
|
||||||
|
race conditions in
|
||||||
|
.Fn JsonConsumeWhitespace .
|
||||||
|
This function, and a few others, expect I/O to be blocking, but
|
||||||
|
the
|
||||||
|
.Xr HttpServer 3
|
||||||
|
sets up I/O to be non-blocking, leading to occasional failures in
|
||||||
|
JSON parsing.
|
||||||
.El
|
.El
|
||||||
.Sh v0.2.1
|
.Sh v0.2.1
|
||||||
.Pp
|
.Pp
|
||||||
|
@ -141,7 +232,7 @@ Misc:
|
||||||
.Bl -bullet
|
.Bl -bullet
|
||||||
.It
|
.It
|
||||||
Fixed a bug in
|
Fixed a bug in
|
||||||
.Xr td 8
|
.Xr td 1
|
||||||
that caused
|
that caused
|
||||||
.Xr cvs 1
|
.Xr cvs 1
|
||||||
to be invoked in the wrong directory when tagging a new release.
|
to be invoked in the wrong directory when tagging a new release.
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
.Dd $Mdocdate: January 6 2023 $
|
.Dd $Mdocdate: March 10 2023 $
|
||||||
.Dt TELODENDRIA-CONTRIBUTING 7
|
.Dt TELODENDRIA-CONTRIBUTING 7
|
||||||
.Os Telodendria Project
|
.Os Telodendria Project
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
|
@ -93,7 +93,7 @@ fact, I find it easier than having to make a GitHub account, forking a
|
||||||
project's repository, and then making a pull request for it. Once you have
|
project's repository, and then making a pull request for it. Once you have
|
||||||
made your changes in your local copy of the code, and you've configured your
|
made your changes in your local copy of the code, and you've configured your
|
||||||
environment properly as noted in the manual for
|
environment properly as noted in the manual for
|
||||||
.Xr td 8 ,
|
.Xr td 1 ,
|
||||||
just run the patch recipe:
|
just run the patch recipe:
|
||||||
.Bd -literal -offset indent
|
.Bd -literal -offset indent
|
||||||
$ td patch
|
$ td patch
|
||||||
|
@ -119,10 +119,10 @@ Subject: Document Patch Procedure
|
||||||
.sp
|
.sp
|
||||||
As much information should be filled out for you, such as the date. An
|
As much information should be filled out for you, such as the date. An
|
||||||
attempt to fill out the From header was also made by
|
attempt to fill out the From header was also made by
|
||||||
.Xr td 8 ,
|
.Xr td 1 ,
|
||||||
but the information there can be modifed as necessary. Consult the manual
|
but the information there can be modifed as necessary. Consult the manual
|
||||||
for
|
for
|
||||||
.Xr td 8
|
.Xr td 1
|
||||||
for more details. The Subject should very briefly describe what the patch
|
for more details. The Subject should very briefly describe what the patch
|
||||||
is about.
|
is about.
|
||||||
.sp
|
.sp
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
.Dd $Mdocdate: February 15 2023 $
|
.Dd $Mdocdate: March 10 2023 $
|
||||||
.Dt TELODENDRIA 7
|
.Dt TELODENDRIA 7
|
||||||
.Os Telodendria Project
|
.Os Telodendria Project
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
|
@ -165,7 +165,7 @@ be afraid to call me out!
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Xr telodendria 8 ,
|
.Xr telodendria 8 ,
|
||||||
.Xr telodendria.conf 5 ,
|
.Xr telodendria.conf 5 ,
|
||||||
.Xr td 8
|
.Xr td 1
|
||||||
.Sh STANDARDS
|
.Sh STANDARDS
|
||||||
The installed version of
|
The installed version of
|
||||||
.Nm
|
.Nm
|
||||||
|
|
Loading…
Reference in a new issue