# README-desktop
# File last changed: May 23, 2021

Makefile Usage:

    The Makefile installs into /usr

    make usage            - gives Makefile usage
    make                  - creates the xml file from the from xml-in file
                            if the xml-in file is newer than the xml file
    make validate         - validates the xml file
    make install          - installs icons, desktop file and xml file
                          - updates the installed icon files cache
                          - updates appdata from the installed appdata xml file
    make install-update   - same as install
    make install-noupdate - same as install but no updates

    make screenshots      - updates local appdata screenshots

    make update           - updates gnome-software (must be user not root)

    make install-desktop  - installs desktop file

    make install-icons    - installs icons
    make update-icons     - updates the installed icon files cache

    make install-appdata  - installs appdata xml file
    make update-appdata   - updates appdata from the installed appdata xml file

xml usage:

    xml directory: /usr/share/metainfo

    ./xml ls        - ls -l on the installed xml file
    ./xml validate  - validates the xml file
    ./xml install   - installs and updates the xml file
    ./xml uninstall - uninstalls the xml file

Generate a template from the desktop:
    appstream-util appdata-from-desktop ncid.desktop ncid.appdata.xml

Website images needed by ncid.appdata.xml:
They need to be in http://ncid.sourceforge.net/details/

    appdata-ncid-call.png
    appdata-ncid-docs.png
    appdata-ncid-line-types.png
    appdata-ncid-mesg.png
    appdata-ncid-night-theme.png
    appdata-ncid-select-columns.png

Vector graphic source files used to create the raster graphic (.png) images:

    ncid-128x128.ai  - Edit with Adobe Illustrator (Windows, Macintosh)
    ncid-128x128.svg - Edit with Inkscape (most operating systems)

    These files are provided in case future icons are needed in different
    dimensions. Using one of these as a starting point should result in a
    higher quality raster graphic.

    Adobe Illustrator was used to create ncid-128x128.svg. Inkscape has
    some oddities as an editor so the Adobe Illustrator version is provided
    as an alternative and as the original from which all others were derived.
