Skip to content

Conversation

zkamvar
Copy link
Contributor

@zkamvar zkamvar commented Mar 7, 2016

Documenting the fact that USERID and GROUPID need to be set to superuser for this to work.

Documenting the fact that `USERID` and `GROUPID` need to be set to superuser for this to work.
## test the build by issuing 'make test', which at present is
## synonymous with 'make html'. I.e., the website build is tested by
## rendering all HTML content.
## test the build by issuing 'USERID=0 GROUPID=0 make test', which at
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Well, this is only true on MacOSX, and on Unix will actually cause the build to fail! Moreover, on Linux you instead have to set SUDO (to, in most cases, "sudo"), like so:

$ SUDO=sudo make html

or otherwise the invocation of Docker will typically fail. (But setting SUDO on MacOSX will most likely cause the build to fail.)

One wishes Docker behaved the same on all systems, but because systems like MacOSX have to run Docker within a VM, whereas it runs natively on Linux, the behaviors are different in sometimes subtle ways.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Perhaps it would be better to include a whole section of docu-comment for different OSes?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, I guess.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants