I don't understand node or the maven build process enough to figure it out:
1) to begin with, I didn't have the jsdoc-toolkit debian package installed,
which provides /usr/bin/jsdoc.
2) running the build as root, where all the files are owned by root, gives
this error:
[INFO] --- frontend-maven-plugin:1.12.1:npx (generate-docs) @
> guacamole-common-js ---
> [INFO] Running 'npx jsdoc -c jsdoc-conf.json' in
> /home/jhankins/guac-160rc1/guacamole-client-1.6.0/guacamole-common-js
> [INFO] sh: 1: jsdoc: Permission denied
> [INFO]
> ------------------------------------------------------------------------
> [INFO] Reactor Summary for guacamole-client 1.6.0:
> [INFO]
> [INFO] guacamole-client ................................... SUCCESS [
> 5.919 s]
> [INFO] guacamole-common ................................... SUCCESS [
> 3.221 s]
> [INFO] guacamole-ext ...................................... SUCCESS [
> 3.931 s]
> [INFO] guacamole-common-js ................................ FAILURE [
> 2.344 s]
> [INFO] guacamole .......................................... SKIPPED
So, I install jsdoc-toolkit, which looks to be an older version (
2.4.0+dfsg-7.1) than what is specified in the top-level
.../guacamole-common-js/package.json file:
{
> "description": "Dependencies to be installed by Maven for running unit
> tests and generating documentation",
> "devDependencies": {
> "jsdoc": "^4.0.3",
> "karma": "^6.4.4",
> "karma-firefox-launcher": "^2.1.3",
> "karma-jasmine": "^5.1.0"
> }
> }
Now, when I build again as root, with files owned by root, I get the error
I first reported:
>
>
> [INFO] --- frontend-maven-plugin:1.12.1:npx (generate-docs) @
> guacamole-common-js ---
> [INFO] Running 'npx jsdoc -c jsdoc-conf.json' in
> /home/jhankins/guac-160rc1/guacamole-client-1.6.0/guacamole-common-js
> [INFO] An argument like -d=<directory> or --directory=<directory> is
> mandatory!
> [INFO] Try 'jsdoc --help' or 'man jsdoc' for more information.
> [INFO]
> ------------------------------------------------------------------------
> [INFO] Reactor Summary for guacamole-client 1.6.0:
> [INFO]
> [INFO] guacamole-client ................................... SUCCESS [
> 4.314 s]
> [INFO] guacamole-common ................................... SUCCESS [
> 1.980 s]
> [INFO] guacamole-ext ...................................... SUCCESS [
> 3.801 s]
> [INFO] guacamole-common-js ................................ FAILURE [
> 2.199 s]
> [INFO] guacamole .......................................... SKIPPED
Confusingly, as a non-root user where the files are owned by that user,
everything builds fine, even without the jsdoc-toolkit debian package
installed, which makes me think something in the build process downloads
jsdoc (a version >= 4.0.3, which does NOT throw an error where it is called
with no "-d=" argument) but this doesn't happen in the case of the root
user?
On Mon, May 5, 2025 at 3:42 PM Vincent Sherwood
<vince...@itsolutions.ie.invalid> wrote:
> I see the same.
>
> I downloaded the Client and Server tgz files from the "draft" 1.6 page (
> https://guacamole.apache.org/releases/1.6.0/) on a Windows laptop then
> transferred them to a Rocky9 machine.
>
> When I Untar/GZip them the ownership of the resulting folder is
> ossimagent:ossimagent and building it yields the same error as Jonathan
> reported below.
>
> If I
>
> chown -R root:root guacamole-client-1.6.0
>
> and rebuild then the build completes successfully.
>
> Vincent
>
> ------------------------------
> *From:* Hankins, Jonathan <jhank...@homewood.k12.al.us.INVALID>
> *Sent:* Monday 5 May 2025 17:58
> *To:* user@guacamole.apache.org <user@guacamole.apache.org>
> *Subject:* Re: Now up for final testing: 1.6.0-RC1
>
> Mike,
>
> I'm getting a build error on RC1 that I wasn't on a previous build I did
> of guacamole-client-staging-1.6.0 (Feb 24, downloaded ZIP files from git).
> Building on Debian bookworm (12.10).
>
> [INFO] --- frontend-maven-plugin:1.12.1:npx (generate-docs) @
> guacamole-common-js ---
> [INFO] Running 'npx jsdoc -c jsdoc-conf.json' in
> /home/jhankins/guac-160rc1/guacamole-client-1.6.0/guacamole-common-js
> [INFO] An argument like -d=<directory> or --directory=<directory> is
> mandatory!
> [INFO] Try 'jsdoc --help' or 'man jsdoc' for more information.
> [INFO]
> ------------------------------------------------------------------------
> [INFO] Reactor Summary for guacamole-client 1.6.0:
> [INFO]
> [INFO] guacamole-client ................................... SUCCESS [
> 4.314 s]
> [INFO] guacamole-common ................................... SUCCESS [
> 1.980 s]
> [INFO] guacamole-ext ...................................... SUCCESS [
> 3.801 s]
> [INFO] guacamole-common-js ................................ FAILURE [
> 2.199 s]
> [INFO] guacamole .......................................... SKIPPED
>
>
> On Sat, May 3, 2025 at 6:22 PM Michael Jumper <mjum...@apache.org> wrote:
>
> Hello all,
>
> The first release candidate for 1.6.0 is now under vote:
>
> https://lists.apache.org/thread/n3zq9v0t638p4hy06kghq1j3lhwdlwds
> <https://urldefense.proofpoint.com/v2/url?u=https-3A__lists.apache.org_thread_n3zq9v0t638p4hy06kghq1j3lhwdlwds&d=DwMFaQ&c=euGZstcaTDllvimEN8b7jXrwqOf-v5A_CdpgnVfiiMM&r=rV1TaS57Er-iXt3xuQ-z-tdNjnF1gnRuIFzegdtXxq0&m=ZrPKW6-L_nGy9N3W8guqNknNOge2MOuVUrj4BI3R3T8PwkgzJnY_A9rrOumHV0Xa&s=p5SlqUqedMgNzQKyBiGnoMwYkBP9DxU11sQv7B3ZARw&e=>
>
> Given the size of this release, if anyone feels like testing RC1, please
> do! As mentioned in the above thread, this release contains a rewrite of
> the rendering system - a major core component that can have subtle
> effects on Guacamole's connections.
>
> If there's anything from these changes that causes issues warranting
> another RC, this is a good time to test things out and find it. I'll be
> doing the same.
>
> - Mike
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: user-unsubscr...@guacamole.apache.org
> For additional commands, e-mail: user-h...@guacamole.apache.org
>
>
> IT Solutions Email Disclaimer - The information contained in this email
> message, including any files transmitted with it, is confidential and may
> be legally privileged.
>
> This e-mail is intended only for the personal attention of the stated
> addressee(s). Any access to this email, including any files transmitted
> with it, by any other person is unauthorised. If you are not an addressee,
> you must not disclose, copy, circulate or in any other way use or rely on
> the accuracy or completeness of the information contained in this email or
> any files transmitted with it.
>
> If you have received this email in error, please inform the sender
> immediately and delete it and all copies from your system. You may not
> forward this email without the permission of the authorised sender.
>
> The views expressed in this email are those of the author, and do not
> necessarily represent the views of IT Solutions or its affiliates. Internet
> communications are not secure and IT Solutions cannot therefore accept
> legal responsibility for the contents of this message nor for any damage
> caused by viruses. This email has been scanned at the originating end. For
> further information on IT Solutions visit https://www.itsolutions.ie
>
