WelcomeWelcome | FAQFAQ | DownloadsDownloads | WikiWiki

Author Topic: PicFormat documentation how to  (Read 1994 times)

Offline rullolex

  • Full Member
  • ***
  • Posts: 134
    • Rullolex
PicFormat documentation how to
« on: March 29, 2021, 01:22:46 PM »
Hi to everyone,

I'm writing a documentation how to for PicFormat that is a command line program that allows us to easily manipulate the resizing, rotation, and format change of images (i. e. from .jpg to .png).

I hope it can be helpfull.

P.s.: this is the first time I write a how to, suggestions are welcome

thank you

Online Rich

  • Administrator
  • Hero Member
  • *****
  • Posts: 11230
Re: PicFormat documentation how to
« Reply #1 on: March 29, 2021, 07:57:51 PM »
Hi rullolex
I made the following changes:
1. I reformatted the text to keep the line lengths down to 75 characters or less. You should be able to view the file in
   an 80 character terminal using the  less  command without extra line wrapping occurring:
Code: [Select]
less PicFormat-doc.txt2. I suspect you had your tabs set to 4 spaces, terminals use 8. I replaced them with 4 spaces.
3. Adjusted grammar in a few sentences.
4. I removed the following section because it goes without saying. This is expected behavior of pretty much all programs:
Quote
NOTE: PicFormat do not require the full path of the image to works if you move into the image folder.
I.e.
PicFormat -i /home/tc/Immagini/prova.jpg -o /home/tc/Immagini/prova.png
and
PicFormat -i prova.jpg -o prova.png

will be the same if you move into the Immagini folder

Overall you did a fine job. I doubt I could have done half as good a job translating to Italian.
I attached an updated copy for your review.

Offline rullolex

  • Full Member
  • ***
  • Posts: 134
    • Rullolex
Re: PicFormat documentation how to
« Reply #2 on: March 29, 2021, 11:59:22 PM »
Hi Rich,

I wrote that for new users that approach the command line (I don't know that at the beginning because no one learn me)

4. I removed the following section because it goes without saying. This is expected behavior of pretty much all programs:
Quote
NOTE: PicFormat do not require the full path of the image to works if you move into the image folder.
I.e.
PicFormat -i /home/tc/Immagini/prova.jpg -o /home/tc/Immagini/prova.png
and
PicFormat -i prova.jpg -o prova.png

will be the same if you move into the Immagini folder

I will edit my file asap

Offline rullolex

  • Full Member
  • ***
  • Posts: 134
    • Rullolex
Re: PicFormat documentation how to
« Reply #3 on: March 31, 2021, 07:21:48 AM »
Hi,

after the Rich's suggestions, I  apply some modif, add some note and examples.
I think now it is better.
I attach the english and the italian files
regards
« Last Edit: March 31, 2021, 07:39:49 AM by Rich »

Online Rich

  • Administrator
  • Hero Member
  • *****
  • Posts: 11230
Re: PicFormat documentation how to
« Reply #4 on: March 31, 2021, 07:44:52 AM »
Hi rullolex
One tiny spelling mistake:
Quote
the parameter of height of 600 pixels it is enought:
There is no  t  in  enough.

I replaced the copy you posted in reply #3 with a corrected copy.

Offline rullolex

  • Full Member
  • ***
  • Posts: 134
    • Rullolex
Re: PicFormat documentation how to
« Reply #5 on: March 31, 2021, 07:54:15 AM »
Hi rullolex
One tiny spelling mistake:
Quote
the parameter of height of 600 pixels it is enought:
There is no  t  in  enough.

I replaced the copy you posted in reply #3 with a corrected copy.


Thank you Rich

Online Rich

  • Administrator
  • Hero Member
  • *****
  • Posts: 11230
Re: PicFormat documentation how to
« Reply #6 on: March 31, 2021, 07:58:46 AM »
Hi rullolex
You are welcome.