From 0536c6bcad4dea50bcc7787ae53b85adac3ef24c Mon Sep 17 00:00:00 2001 From: Peter De Wachter Date: Sat, 27 Jan 2018 00:17:51 +0100 Subject: [PATCH] Updated/expanded readme --- README.md | 66 +++++++++++++++++++++++++++++++++++++++++++------------ 1 file changed, 52 insertions(+), 14 deletions(-) diff --git a/README.md b/README.md index 6a09ad0..e4c8e70 100644 --- a/README.md +++ b/README.md @@ -1,12 +1,14 @@ -Driver for (some) Brother laser printers -======================================== +brlaser: Brother laser printer driver +===================================== -Most Brother printers support a standard printer language such as PCL -or PostScript, but not all do. If you have a monochrome Brother laser -printer (or multi-function device) and the other open source drivers -don't work, this one might help. +brlaser is a CUPS driver for Brother laser printers. -It is known to support these printers: +Although most Brother printers support a standard printer language +such as PCL or PostScript, not all do. If you have a monochrome +Brother laser printer (or multi-function device) and the other open +source drivers don't work, this one might help. + +This driver is known to support these printers: * Brother DCP-1510 series * Brother DCP-7030 @@ -15,16 +17,52 @@ It is known to support these printers: * Brother DCP-7065DN * Brother MFC-7360N + +Other printers +-------------- + +If your printer isn't included in the list above, just try selecting +any entry marked 'brlaser' and see if it works. + +If it does, please create a new issue here in Github and include the +output of this command: + + sudo lpinfo --include-schemes usb -l -v + +Then I'll be able to add a proper entry for your printer. + + Installation ------------ -Ubuntu: -``` -sudo apt-get install autoreconf cups-development libcupsimage2-dev -./autogen.sh -make -sudo make install -``` +Some operating systems already ship this driver. This is the case for +at least Debian, Ubuntu, Raspbian, openSUSE and Arch Linux. Look for a +package named `printer-driver-brlaser`. + +You'll also need Ghostscript, in case that's not installed +automatically. + +Once brlaser is installed, you can add your printer using the usual +CUPS interface. + + +Building from source +-------------------- + +To compile brlaser you'll need CMake and the CUPS development packages +(libcups2-dev, libcupsimage2-dev or similar). + +Get the code by cloning the git repo . Compile and install with these commands: + + cmake . + make + sudo make install + +It might be needed to restart CUPS after this. + +[latest release]: https://github.com/pdewacht/brlaser/releases/latest + Copyright ---------