View Issue Details
| ID | Project | Category | View Status | Date Submitted | Last Update |
|---|---|---|---|---|---|
| 0007019 | Taler | documentation | public | 2021-09-17 09:48 | 2022-11-04 20:53 |
| Reporter | Christian Grothoff | Assigned To | ttn | ||
| Priority | normal | Severity | text | Reproducibility | N/A |
| Status | closed | Resolution | reopened | ||
| Platform | i7 | OS | Debian GNU/Linux | OS Version | squeeze |
| Product Version | git (master) | ||||
| Target Version | 0.9 | Fixed in Version | 0.9 | ||
| Summary | 0007019: man pages missing for sync commands | ||||
| Description | Specifically, sync-httpd and sync-dbinit. Should be very similar to the other -httpd and -dbinit commands. Also, it would be good if we had a man page for the various options of sync (man 5 sync.conf). Once those are written, we need to import the 'prebuilt' submodule into sync.git, modify the build system to include the man pages (sync-only) and update the Debian packaging of sync. | ||||
| Tags | No tags attached. | ||||
|
|
See for a start: https://git.taler.net/docs.git/commit/?id=e3cc1ff85bf01145b4a8e9865c5832e0dce53a16 Feedback welcome! |
|
|
Looks good to me! |
|
|
Re-opening since the sync.conf(5) page hasn't yet been written (WIP). |
|
|
Question: Is the sync.conf syntax the same as taler.conf syntax? (Perhaps we can factor out the common text into frags/conf-syntax-rst, or somesuch.) |
|
|
Yes. |
|
|
I just realized there is also a need for sync-config(1) manpage. |
|
|
See https://git.taler.net/docs.git/commit/?id=95a7133ef140bf285ef5640ad9db250b13f16301 for a s/taler-config/sync-config/g treatment. |
|
|
See https://git.taler.net/docs.git/commit/?id=49ed051fd55cc7df9aa84455d1efef6efadf350a The subsequent commits evenly distribute references to the sync* manpages in the respective See Also sections. We can probably close this bug now. (I am not familiar w/ how to do the other tasks, maybe that should be in another bug?) |
|
|
OTOH, thinking more about it, there's no harm if i try the other parts. Let's see how things go... |
|
|
I have done some further work on this: - https://git.taler.net/docs.git/commit/?id=5be6d4c68d3369b80b54442dda9b8cb3b1095518 - https://git.taler.net/sync.git/commit/?id=1ff8a42a7f42ad8f875be581e6c1d7385e5ba811 - https://git.taler.net/sync.git/commit/?id=667290c82418b63e258fb61da0d51db429b8665b I took a brief look at sync.git/debian/* and it seems like it would be easy to add a few lines to the various *.install files, but i am unsure how to actually proceed. |
|
|
Not sure I understand your question. If it is about modifying the Debian packages to ship the man pages, just go ahead. Otherwise I'm unclear what you'd like to accomplish with the debian/* files. |
|
|
I took the plunge and modified two .install files: - https://git.taler.net/sync.git/commit/?id=81f4e8033c05ca52741c654f748665154dd78b06 Hopefully the changes are in the right place and in the right format. |
|
|
Looks fine. Bug resolved? |
|
|
I will document (a bit) the workings w/ the branch 'prebuilt' in the docs.git/README. Marking this one resolved. Hooray! |
| Date Modified | Username | Field | Change |
|---|---|---|---|
| 2021-09-17 09:48 | Christian Grothoff | New Issue | |
| 2021-09-17 09:48 | Christian Grothoff | Status | new => assigned |
| 2021-09-17 09:48 | Christian Grothoff | Assigned To | => ttn |
| 2021-11-24 16:06 | ttn | Note Added: 0018527 | |
| 2021-11-24 17:42 | Christian Grothoff | Note Added: 0018528 | |
| 2021-11-24 17:42 | Christian Grothoff | Status | assigned => resolved |
| 2021-11-24 17:42 | Christian Grothoff | Resolution | open => fixed |
| 2021-11-24 17:42 | Christian Grothoff | Fixed in Version | => 0.9 |
| 2021-11-24 17:42 | Christian Grothoff | Target Version | 0.8.5 => 0.9 |
| 2021-11-24 21:26 | ttn | Status | resolved => feedback |
| 2021-11-24 21:26 | ttn | Resolution | fixed => reopened |
| 2021-11-24 21:26 | ttn | Note Added: 0018532 | |
| 2021-11-24 22:12 | ttn | Note Added: 0018534 | |
| 2021-11-25 00:09 | Christian Grothoff | Note Added: 0018537 | |
| 2021-11-25 00:09 | Christian Grothoff | Status | feedback => assigned |
| 2021-11-26 23:43 | ttn | Note Added: 0018554 | |
| 2021-11-26 23:52 | ttn | Note Added: 0018555 | |
| 2021-11-27 00:38 | ttn | Note Added: 0018556 | |
| 2021-11-27 09:28 | ttn | Note Added: 0018557 | |
| 2021-12-23 09:10 | ttn | Note Added: 0018583 | |
| 2021-12-23 10:17 | Christian Grothoff | Note Added: 0018584 | |
| 2021-12-23 10:36 | ttn | Note Added: 0018585 | |
| 2021-12-23 20:56 | Christian Grothoff | Note Added: 0018586 | |
| 2021-12-24 02:51 | ttn | Status | assigned => resolved |
| 2021-12-24 02:51 | ttn | Note Added: 0018587 | |
| 2022-11-04 20:53 | Christian Grothoff | Status | resolved => closed |
