# tigervnc/cfg - "Build" settings for package

#---------------------------------------------------------------------

[technotes]

1. The source tarball used by this package was created  based on "git"
upstream sources. The sources were obtained as follows:

      ocgitfetch --run https://github.com/TigerVNC/tigervnc.git

#---------------------------------------------------------------------

2. The sysadmin can set the TigerVNC password for a particular user as
follows:

      USER=sally            # Account name
      #
      su -l -c - $USER vncpasswd

The user can set the password themselves using:

      vncpasswd

#---------------------------------------------------------------------

3. The sysadmin  and/or  system  startup scripts can start  a TigerVNC
server for a particular user as follows:

VUSER=sally         # Linux user account name
VDISPLAYNUM=3       # A display number from 1 to 9

if [ "@$VUSER" == "@root" ]; then
    USERHOME=/root
else
    USERHOME/home/$VUSER
fi

nohup su -l -c - $VUSER "xinit $PRODTREE/jwm/bin/jwm -- \
$PRODTREE/xorg/bin/Xvnc :$VDISPLAYNUM \
--PasswordFile=$USERHOME/.vnc/passwd \
-render -extension MIT-SHM \
-geometry 1024x700" >& /tmp/vnc-$VUSER.log &

#---------------------------------------------------------------------

4. Subsequently,  remote users should be able to connect to the server
using a VNC client program directed to a server identifier of the fol-
lowing form:

      something.com:5903

Substitute the appropriate hostname or IPV4 here for  "something.com".
Substitute 5900 plus $VDISPLAYNUM for "5903".

"remmina" works well.  Note: When using "remmina" to connect to Tiger-
VNC, remember to specify VNC as opposed to Spice protocol.

#---------------------------------------------------------------------

5. As of Fall 2021, this package could be built using "git" copies but
not release tarballs.

#---------------------------------------------------------------------

6. As of Fall 2021,  the usual rule about  creating a new subdirectory
to run "cmake" in didn't work for this package.

"cmake" had to be run  in the  top-level source directory  or  the 2nd
stage of the "build" [the stage that build the server component of the
package] wouldn't work.

#---------------------------------------------------------------------

7. The following "xserver" "configure" switches are omitted due to be-
ing unrecognized options:

      --disable-config-dbus
      --enable-install-libxf86config
      --with-dri-driver-path=$PF/lib/dri
      --with-fontdir=$PF/share/fonts/X11

#---------------------------------------------------------------------

8. The following  "xserver" "configure" switch is  omitted pending re-
view:
      --with-default-font-path=\
"catalogue:/etc/X11/fontpath.d,built-ins"

#---------------------------------------------------------------------

[buildtimes]

00.07 hours (or 004.10 minutes) - 2023 dedi Xeon E3-1200 v3  4x2  32GB
                                  RAM

#---------------------------------------------------------------------

[settings]
configure = none
defer     = glibc64
license   = See "license*.txt" in installed tree
licfile   = LICENCE.TXT
tmpsize   = 172M

setpaths  = fltk13 fontconfig gnutls3 jpeg linux-pam xorg zlib

#---------------------------------------------------------------------

[depends]
actools
brotli
bzip2
cmake
expat
fltk13
fontconfig
freetype2
gawk
gnutls3
graphite2
grep
gtkcore
jpeg
libbsd
libffi
libgmp
libidn2
libpng
libunistring
linux-pam
ncurses
nettle3
p11kit
pcre2
sed
util-linux
xorg:strict
zlib
zstd

#---------------------------------------------------------------------

[build]

# Courtesy of BLFS
mkdir -p unix/xserver
tar Jxf $PKGDIR_SPECIAL/xorg-server-21.1.6.tar.xz \
    --strip-components=1 -C unix/xserver

#---------------------------------------------------------------------

cmake \
    -G "Unix Makefiles" \
    -DCMAKE_BUILD_TYPE=RELEASE           \
    -DCMAKE_INSTALL_PREFIX=$PKGDIR_PROD  \
    -DCMAKE_INSTALL_LIBDIR=lib           \
    -DINSTALL_SYSTEMD_UNITS=OFF          \
    -Wno-dev .

smpmake && make install

#---------------------------------------------------------------------

PREFIX_XORG=$PRODTREE/xorg
PF=$PREFIX_XORG
XTRANS=$PF/share/aclocal/xtrans.m4

ls      $XTRANS
ln -nsf $XTRANS /$LACARCH/aclocal/
ln -nsf         /$LACARCH/aclocal/xtrans.m4 \
        $PRODTREE/actools/share/aclocal/

#---------------------------------------------------------------------

# Courtesy of BLFS
cd unix/xserver
patch -Np1 -i ../xserver21.1.1.patch
autoreconf -fiv

./configure \
    --prefix=$PF                \
    --enable-dri2               \
    --enable-dri3               \
    --enable-glx                \
    --with-pic                  \
    --without-dtrace            \
\
    --disable-config-hal        \
    --disable-config-udev       \
    --disable-devel-docs        \
    --disable-dmx               \
    --disable-dri               \
    --disable-kdrive            \
    --disable-selective-werror  \
    --disable-static            \
    --disable-unit-tests        \
    --disable-xephyr            \
    --disable-xinerama          \
    --disable-xnest             \
    --disable-xorg              \
    --disable-xvfb              \
    --disable-xwin              \
\
    --with-xkb-path=$PF/share/X11/xkb    \
    --with-xkb-bin-directory=$PF/bin

smpmake && make install

#---------------------------------------------------------------------

# Original URLs. These URLs were valid at one point, but may have died
# since then. If you download newer versions of tarballs [etc.], don't
# delete  the  original versions,  as you may not  be able  to replace
# them.

[urls]
url_debian  = tbd
url_home    = tbd
url_lfs     = tbd
url_tarball = git               # See "technotes" in "cfg" file

#---------------------------------------------------------------------

[history]
211224 Added package. Started with 3ca59d3cc ("git" hash).
220620 Updated to af3e754a4
230324 Updated to 7a2af9744