<div dir="auto"><div><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Fri, Mar 20, 2020, 3:36 PM Didier Spaier <<a href="mailto:didier@slint.fr">didier@slint.fr</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Le 20/03/2020 à 21:25, B Watson a écrit :<br>
> On 3/20/20, Didier Spaier <<a href="mailto:didier@slint.fr" target="_blank" rel="noreferrer">didier@slint.fr</a>> wrote:<br>
>> Hi,<br>
>><br>
>> I intend to upgrade espeakup, dynamically linked to espeak-ng not<br>
>> espeak, as speech is then way better (tested by Slint users).<br>
>><br>
>> Indeed I will provide a SlackBuild for espeak-ng but that leads to a few<br>
>> questions.<br>
>><br>
>> For both espeakup and espeak-ng I do a "git archive <commit>".<br>
>><br>
>> 1. How should I name $VERSION? git<commit>, <commit>, git_commit?<br>
> <br>
> epeak-ng version 1.50 was released 4 months ago, is the latest git really<br>
> that much better than the release? If not, I'd stick with the release.<br>
<br>
Thare have been several fixes that worth an upgrade, I think. And the<br>
version I consider is already used in Slint since two weeks with no<br>
reported issue (I have explicitly requested a feedback), both in console<br>
mode through espeakup and in graphical environments through speech-dispatcher<br>
and Orca.<br>
<br>
> If you decide you really have to upgrade to the latest git, I'd recommend<br>
> using a version number like this:<br>
> <br>
> 1.50+yyyymmdd_<commit><br>
> <br>
> where yyyymmdd is the date of the commit, and <commit> is the 7-digit<br>
> commit ID.<br>
<br>
Will do.<br>
<br>
> In fact... I was gonna say, use the git2tarxz.sh script from<br>
> multimedia/straw-viewer, but I had to modify it some to make it work<br>
> with espeak-ng (due to them using tags in a way my script wasn't smart<br>
> enough to handle).<br>
> <br>
> So try this: <a href="http://urchlay.naptime.net/~urchlay/src/git2tarxz.sh.espeak-ng" rel="noreferrer noreferrer" target="_blank">http://urchlay.naptime.net/~urchlay/src/git2tarxz.sh.espeak-ng</a><br>
> <br>
> The result is a tarball called espeak-ng-1.50+20200317_7a44961a.tar.xz,<br>
> which you can use as your source and host somewhere. Since you're talking<br>
> about including pregenerated docs (below), you'll want to add them to<br>
> this tarball.<br>
> <br>
> If you use the git2tarxz script, please do include it in your SlackBuild<br>
> tarball.<br>
<br>
Will do, thanks for sharing. I have a similar script but targeting a<br>
locally cloned repository, so yours is indeed better to ship as the<br>
SlackBuild's user can then re-generate the archive if he or she wants to.  <br>
<br>
>> 2. If I indicate in the README the command to use to get the source<br>
>> archive, tools that automatize source downloads won't work. Is there a<br>
>> recommended place to store the source archive?<br>
> <br>
> Possibly here: <a href="https://sourceforge.net/projects/slackbuildsdirectlinks/" rel="noreferrer noreferrer" target="_blank">https://sourceforge.net/projects/slackbuildsdirectlinks/</a><br>
<br>
This was also suggested by Matteo (thanks!). On second thought I could<br>
as well store these archive on my own server (Linode VPS) as they are <br>
not big.<br>
<br>
>> 3. For espeak-ng I use tools like pandoc and ruby-ronn to build the<br>
>> documentation. As it seems unreasonable to require them, can I assume<br>
>> that including their output in the tarball is OK?<br>
> <br>
> Yes, I'd say including prebuilt docs is a good solution, *especially*<br>
> since pandoc has 138 (!) dependencies.<br>
> <br>
> If some of the docs are strictly for developers (e.g. guide to hacking<br>
> on its source, API documentation on how to use espeak-ng as a library),<br>
> I'd even say don't include them at all, or add a DOCS=yes variable<br>
> (defaulting to no). The vast majority of users aren't going to need<br>
> developer docs, it's sorta silly to make them chase down a huge chain<br>
> of dependencies to build documentation they aren't going to read.<br>
<br>
I will check that and probably include prebuilt docs.<br>
<br>
Cheers,<br>
Didier<br></blockquote></div></div><div dir="auto"><br></div><div dir="auto"><span style="font-family:sans-serif">Is there a reason to host a tarball separately vs just grabbing the tarball directly from GitHub? You can download the source from a specific commit using the following URL (based on the latest commit, but you can just switch it to the commit you need - hopefully I did it right, since I'm doing this on my phone). You aren't limited to just downloading releases.</span><div dir="auto" style="font-family:sans-serif"><br></div><div dir="auto" style="font-family:sans-serif"><a href="https://github.com/espeak-ng/espeak-ng/archive/7a44961/espeak-ng-7a44961ac3abce0b390131c9832085e9eba0b92c.tar.gz">https://github.com/espeak-ng/espeak-ng/archive/7a44961/espeak-ng-7a44961ac3abce0b390131c9832085e9eba0b92c.tar.gz</a></div><div dir="auto" style="font-family:sans-serif"><br></div><div dir="auto" style="font-family:sans-serif">If you want to see an example of how I do this in a SlackBuild, check out glportal on SBo.</div><div dir="auto" style="font-family:sans-serif"><br></div><div dir="auto" style="font-family:sans-serif"><a href="http://slackbuilds.org/repository/14.2/games/glportal/">http://slackbuilds.org/repository/14.2/games/glportal/</a></div><div dir="auto" style="font-family:sans-serif"><br></div><div dir="auto" style="font-family:sans-serif">Jeremy</div></div><div dir="auto"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
</blockquote></div></div></div>