ShoppingList
============
ShoppingList - Print a list for shopping
Copyright (C) 2014 Allen Fairfield
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
--------------------
Installing in Linux:
--------------------
Download shoppinglist-<version_number>.tar.gz, unpack it and run these
commands in a terminal:
qmake
make
make install (as root, or use sudo make install)
Your executable (ShoppingList) will be found in /usr/local/ShoppingList,
and a PDF user manual in the doc subdirectory found there.
Requires Qt4.8 and qt-devel packages to compile and run.
----------------------
Installing in Windows:
----------------------
There are two ways to install - the manual install and the
Windows installer.
Manual Install
= = = = = = = =
The manual install is a zip archive of the
files needed to run this application. Download the zip file,
unzip it, and copy the contents, including the "imageformats"
folder, to a folder on your Windows PC. Double click the file
"ShoppingList.exe" to run it. This was uploaded after experiencing
a "suspicious" flag from the anti-virus software, possibly because
the installer adds things to the Windows registry. Use this install
method if that worries you. If you feel brave, or cannot figure
out how to manually install, use the Windows installer.
Windows Installer
= = = = = = = = =
Download the installer (ShoppingList-<version_number>-Setup.exe) and run
it. It might be a good idea to uninstall any older version before
installing this. Your shopping list files will not be deleted in the
process. When completed, you should see ShoppingList in the start menu.
Compiled on Windows XP 32 bit, tested on Windows 2000, Windows XP
32 bit, and Windows 7 64 bit. Hopefully it also runs on newer versions
of Windows.
-------------------
General Information
-------------------
ShoppingList does not touch the Windows registry! Only the installer
does. I wrote it this way to avoid trashing your system. The installer
was built with InnoSetup (www.jrsoftware.org/isinfo.php).
It is a good idea to make backup copies of your shopping list files,
and be sure to include the index file! In Linux, these files will be
found in your home directory in a subdirectory named "ShoppingList".
Be sure not to delete that, or you will lose your files. In WindowsXP,
this folder will be located in C:\Documents and Settings\<Your User Name>.
For other versions of Windows it may be different.
ShoppingList 1.0.0 now has options to back up and restore your shopping
lists, as well as export and import single shopping lists. Instructions
for these are found in the Help menu and the PDF manual.
Note: The Windows version is ported using MinGW and Qt stuff for Windows.
It only compiles for 32 bit Windows, but when last used on Windows 7 64 bit,
it ran without problems. I can't vouch for Windows Vista/8/10.
------------------------
August 3, 2017
------------------------
Version 1.0.0 of ShoppingList, Linux version only, has been uploaded.
Some problematic dialogs were replaced, now there is access to USB
FLASH drives, as long as you know where they are located. In openSuse
LEAP 42.2, it is found in:
/run/media/<your user account name>/<name of FLASH drive>
This is with the Dolphin file manager, anyway. If you are not using
KDE / Plasma desktop, it may be located elsewhere. I have no idea.
-----------------------
October 6, 2017
-----------------------
Version 1.0.0 for Windows 32 bit has been uploaded. I recommend only
using USB FLASH drives or SD/SDHC cards for the added backup, restore,
export and import options. Saving backups to Windows "system" folders
is probably not a good idea, but if you do back up to your hard drive,
avoid those folders. It makes more sense to use external media, though.
An exception would be if you want to burn your backups to CD-R discs,
then you might want to back up to a known folder on your hard drive
first.
---------------------------------------------------------------------
Please report any bugs to joeelectronics43@outlook.com
