Vocola-2/RELEASE.txt at master · mathicg/Vocola-2 · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
##
## Mark's notes on how to release a version of Vocola
##
## Still needs work to be comprehensible to others.  :-(
##


git checkout master

Merge any features still not merged
delete those branches (later)


Check release notes complete
       # see what changed:
     git log HEAD --not v2.8.8


Bump version number:

    make clean

    cd src
    find . -type f -exec grep --color=always -H -i '2\.9' {} \; -print | grep -v .git
    ./to_MacroSystem/_vocola_main.py:    print("Vocola version 2.9ALPHA starting...")
    ./to_MacroSystem/_vocola_main.py
    ./README.html:<title>README file for Vocola 2.9ALPHA distribution</title>
    ./README.html:    This version, 2.9ALPHA, requires Dragon NaturallySpeaking (DNS)
    ./README.html
    ./exec/vcl2py/main.py:VocolaVersion = "2.9ALPHA"
    ./exec/vcl2py/main.py
    ./extensions/vocola_ext_vocola.py:    from vocola_common_runtime import set_vocola_verbosity    # Vocola version 2.9+ only
    ./extensions/vocola_ext_vocola.py
    ./Release-2-9-notes.txt:New in 2.9:
    ./Release-2-9-notes.txt

    git commit -a

Bump copyright notices?

    find . -type f -exec grep --color=always -H -i 'copyright' {} \; -print | grep -v .git


Build the release:
    make clean
    make
    cp build/Vocola.zip releases/Vocola-2-9.zip
    git add releases/Vocola-2-9.zip
    git commit -a


# (cd ~/voice/NatLink/trunk; svn update)
# make install
# # update version number in ~/voice/NatLink/trunk/natlinkInstaller/setupnatlinkwithinno.py
# make compare
# (cd ~/voice/NatLink/trunk; svn status)
# (cd ~/voice/NatLink/trunk; svn diff) |& more
# (cd ~/voice/NatLink/trunk; svn commit)


Tag then push the release:
    git tag -a v2.9
Version 2.9, released November 29, 2024

    git checkout master
    git push
    git push origin --tags


Update Vocola website:
    cd ~/voice/Vocola_development/Vocola_net
    git pull
    cd src/v2

    cp ~/voice/Vocola_development/Vocola_2/src/Release-2-9-notes.txt .
    git add Release-2-9-notes.txt
    cp ~/voice/Vocola_development/Vocola_2/releases/Vocola-2-9.zip .
    git add Vocola-2-9.zip

    edit ~/voice/Vocola_development/Vocola_net/src/v2/VocolaVersions.html to add new version
    # Also need to update latest version on:
    ~/voice/Vocola_development/Vocola_net/src/v2/InstallVocola.html

    git commit -a
    git push

    # after a short delay, changes should be live on https://vocola.net/v2/VocolaVersions


Draft then send out announcement to KnowBrainer third-party command utilities forum
  https://forums.knowbrainer.com/forum/third-party-command-utilities-vocola-unimacro-voicepower-python
  see file announcement; save the new announcement at the top

  seems to work better if you join rather than justify paragraphs
  I ended up wrapping the release notes in code (there's a button for that), it lost indentation :-(
  there is a preview button in the new form at the bottom right

+done


bump version number to next # + ALPHA
git commit -a

<checkout vortex branch for instructions for releasing a new version of vortex>

rebase Mark's branches as needed
update ~/infra/bootstrap/my_install_Vocola.bat as needed