Skip to content

Conversation

@girdharagrawalbro
Copy link

@girdharagrawalbro girdharagrawalbro commented Oct 16, 2025

Adds documentation for git-fast-import command.

Examples included:

  • Import from a fast-import stream file
  • Import with progress reporting
  • Import with custom date format
  • Import with object limit
  • Import with maximum pack size

#3953

@github-actions github-actions bot added new command Issues requesting creation of a new page or PRs adding a new page for a command. review needed Prioritized PRs marked for reviews from maintainers. labels Oct 16, 2025

- Import data from a fast-import stream file:

`git fast-import < {{path/to/stream_file}}`
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
`git fast-import < {{path/to/stream_file}}`
`git < {{path/to/stream_file}} fast-import`

https://github.com/tldr-pages/tldr/blob/main/contributing-guides/style-guide.md#argument-order


- Import and show statistics:

`git fast-import --stats < {{path/to/stream_file}}`
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
`git fast-import --stats < {{path/to/stream_file}}`
`git < {{path/to/stream_file}} fast-import --stats`


- Import with a specific maximum number of pack bytes:

`git fast-import --max-pack-size {{size}} < {{path/to/stream_file}}`
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
`git fast-import --max-pack-size {{size}} < {{path/to/stream_file}}`
`git < {{path/to/stream_file}} fast-import --max-pack-size {{size}}`


- Import and create a new pack file when the current one reaches a certain size:

`git fast-import --big-file-threshold {{size}} < {{path/to/stream_file}}`
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
`git fast-import --big-file-threshold {{size}} < {{path/to/stream_file}}`
`git < {{path/to/stream_file}} fast-import --big-file-threshold {{size}}`

@Managor Managor closed this Oct 20, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

new command Issues requesting creation of a new page or PRs adding a new page for a command. review needed Prioritized PRs marked for reviews from maintainers.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants