Browse Source

feat: update documentation

master
Dennis Buchhorn 2 years ago
parent
commit
79bfdbc0d3
2 changed files with 7 additions and 6 deletions
  1. +5
    -4
      README.md
  2. +2
    -2
      scripts/git_wrapper.tcl

+ 5
- 4
README.md View File

@ -37,8 +37,8 @@ Vivado is a pain in the ass to source control decently, so these scripts provide
### Workflow ### Workflow
1. When first starting a project, create it in a folder called `work_dir`
(e.g. `PROJECT_NAME/work_dir`). All the untracked files will be under this directory.
1. When first starting a project, called `PROJECT_NAME`, create it in a folder
called `PROJECT_NAME/work_dir`. All the untracked files will be under this directory.
2. Place your source files anywhere you want in your project folder 2. Place your source files anywhere you want in your project folder
(e.g. `PROJECT_NAME/src`). (e.g. `PROJECT_NAME/src`).
@ -74,11 +74,12 @@ Vivado is a pain in the ass to source control decently, so these scripts provide
3. Initialize the git repository with `git init` on the Tcl Console. This will 3. Initialize the git repository with `git init` on the Tcl Console. This will
create the repository, automatically change to your project directory create the repository, automatically change to your project directory
(`PROJECT_NAME`), generate the `.gitignore` file and stage it.
(`PROJECT_NAME`), generate the `.gitignore` file and a `README.md` file
with basic *how to use* instructions and make the initial commit.
4. Stage your source files with `git add`. 4. Stage your source files with `git add`.
5. When you are done, `git commit` your project. A `PROJECT_NAME.tcl`
5. When you are done, `git commit` your project **within the Tcl Console**. A `PROJECT_NAME.tcl`
script will be created in your `PROJECT_NAME` folder and added to your commit. script will be created in your `PROJECT_NAME` folder and added to your commit.
6. Afterwards, when opening the project after cloning it, do it by using 6. Afterwards, when opening the project after cloning it, do it by using


+ 2
- 2
scripts/git_wrapper.tcl View File

@ -71,13 +71,13 @@ namespace eval ::git_wrapper {
puts $file "" puts $file ""
puts $file "- Wenn you are done, `git add` your source/design files." puts $file "- Wenn you are done, `git add` your source/design files."
puts $file "" puts $file ""
puts $file "- Use the Tcl Console from Vivado to `git commit -m \"COMMIT_MESSAGE\"` your work. The `${current_project}.tcl` file will be recreated"
puts $file "- Use the **Tcl Console** from Vivado to `git commit -m \"COMMIT_MESSAGE\"` your work. The `${current_project}.tcl` file will be recreated"
puts $file "" puts $file ""
puts $file "### Notes" puts $file "### Notes"
puts $file "" puts $file ""
puts $file "#### Block design" puts $file "#### Block design"
puts $file "" puts $file ""
puts $file "When you change a block design, **befor you run synthesis** you have to disable the current HDL wrapper and create a new HDL wrapper for each design!"
puts $file "When you change a block design, **befor you run synthesis** you have to *delete* the current HDL wrapper and *create a new* HDL wrapper for each changed design!"
close $file close $file
# Initialize the repo # Initialize the repo


Loading…
Cancel
Save