Write a user's guide for plotgitsch

[jnavila]

Write a user's guide for plotgitsch

[carlos-pereyra]

Thanks so much jnavila! I think I got the hang of plotgitsch now :)

[carlos-pereyra]

Hi I am on Lubuntu and trying to use this and I am not certain how to run the program correctly.
"plotgitsch -i firefox"

Terminal output.
"internal diff and show with firefox between Git rev HEAD and file system .
Exception (Failure "Value: not a valid compressed object")"

Could you tell me what I am doing wrong? Thanks again.

[jnavila]

It's not clear what happened, but it seems you have some issues with your Git repository. Have you checked in the required files? Is your repo available anywhere?

[carlos-pereyra]

Yes I created a new test repo.
https://github.com/carlos-pereyra/test

There is two commits, so I should be able to compare two sch versions. However I am not sure I am using the command 'plotgitsch' correctly.

When I try the command "plotgitsch -i firefox" again, I get,
"internal diff and show with firefox between Git rev HEAD and file system ." again.

[jnavila]

If you want to compare versions together, you need to specify the revisions. However, your repo cannot be used to show the differences, because your first version does not include the -cache.lib file. The second one would be usable, but with nothing against to compare with, we go nowhere.

[jnavila]

FWIW, you can test plotgitsch on this repo. Just type:

 $ cd circuit
 $ plotgitsch -ifirefox HEAD^

It should open two tabs on firefox, with the differences between the latest revision and the previous one.

[carlos-pereyra]

Thanks. plotgitsch is working for me, however it does not open two tabs, instead it opens one tab with the changes overlaid, which I enjoy.

How do I compare HEAD with n amounts of revisions? Additionally how do I reference two arbitrary revisions? sorry for the naive question. Thanks again!

[jnavila]

This not a naive question. This why a user's guide is needed. You can specify revisions the same way as when using git. See https://git-scm.com/docs/gitrevisions for all the ways to identify revisions.